{"openapi":"3.1.0","info":{"title":"Nexscope Ecommerce Data, SEO, and Creative APIs","version":"2026-08-28-public-catalog-v1","description":"Nexscope APIs provide ecommerce marketplace intelligence, SEO research, and creative generation capabilities through REST and MCP. Authentication uses a Nexscope API key. Pricing is credit-based and actual usage varies by endpoint and workload; current estimates are shown in the Nexscope account.","termsOfService":"https://www.nexscope.ai/terms","contact":{"name":"Nexscope Support","email":"service@nexscope.ai","url":"https://www.nexscope.ai/api-docs"},"license":{"name":"Proprietary API; use subject to Nexscope Terms","url":"https://www.nexscope.ai/terms"}},"externalDocs":{"description":"Nexscope API Documentation","url":"https://www.nexscope.ai/api-docs"},"servers":[{"url":"https://api.nexscope.ai","description":"Production"}],"tags":[{"name":"Amazon Marketplace Intelligence","description":"Amazon product, search, market, review, traffic and policy APIs.","x-category-slug":"amazon-marketplace-intelligence"},{"name":"Keyword & Search Demand","description":"Keyword expansion, search volume, share of voice and ranking intelligence.","x-category-slug":"keyword-search-demand"},{"name":"TikTok / Social Commerce","description":"TikTok Shop products, sellers, videos, creators, livestreams and rankings.","x-category-slug":"tiktok-social-commerce"},{"name":"Temu Marketplace Intelligence","description":"Temu product, category and store source APIs.","x-category-slug":"temu-marketplace"},{"name":"1688 Sourcing","description":"1688 product search, image search and billboard sourcing APIs.","x-category-slug":"1688-sourcing"},{"name":"Shopify Commerce","description":"Shopify product and store query APIs.","x-category-slug":"shopify-commerce"},{"name":"Etsy Marketplace","description":"Etsy product and category discovery APIs.","x-category-slug":"etsy-marketplace"},{"name":"Ozon Marketplace","description":"Ozon product, category, shop, seller and keyword APIs.","x-category-slug":"ozon-marketplace"},{"name":"eBay Marketplace","description":"eBay marketplace product search APIs.","x-category-slug":"ebay-marketplace"},{"name":"Shopee Marketplace","description":"Shopee product search APIs.","x-category-slug":"shopee-marketplace"},{"name":"Search & Trend Intelligence","description":"Google Trends, AI mode search and web search APIs.","x-category-slug":"search-trend-intelligence"},{"name":"Image Generation Models","description":"Dedicated image generation APIs with one fixed model per endpoint.","x-category-slug":"image-generation-models"},{"name":"Video Generation Models","description":"Dedicated video generation APIs with one fixed model per endpoint.","x-category-slug":"video-generation-models"},{"name":"Multimodal AI","description":"Image recognition, image editing, image generation, and ecommerce creative APIs.","x-category-slug":"multimodal-ai"},{"name":"Patent & IP Risk","description":"Patent, trademark, copyright and IP risk APIs.","x-category-slug":"patent-ip-risk"},{"name":"Product & Market Research","description":"General ecommerce product and market research APIs.","x-category-slug":"product-market-research"},{"name":"Amazon Advertising","description":"Amazon advertising access, reporting and campaign intelligence APIs.","x-category-slug":"amazon-advertising"},{"name":"Patent Intelligence","description":"Patent search and intellectual-property research APIs.","x-category-slug":"patent-intelligence"},{"name":"Ecommerce Content Generation","description":"Product description and product video generation APIs.","x-category-slug":"ecommerce-content-generation"},{"name":"Keywords & Trends","description":"Keyword demand, search volume, and trend research APIs.","x-category-slug":"keywords-trends"},{"name":"Search Results & Rankings","description":"Search result, ranking, and SERP research APIs.","x-category-slug":"search-results-rankings"},{"name":"Competitors & Traffic","description":"Competitor and website traffic research APIs.","x-category-slug":"competitors-traffic"},{"name":"Pages & Websites","description":"Website, page, and technical SEO analysis APIs.","x-category-slug":"pages-websites"},{"name":"AI Search & Citations","description":"AI search visibility, mentions, and citation research APIs.","x-category-slug":"ai-search-citations"},{"name":"Backlinks & Authority","description":"Backlink profile and authority research APIs.","x-category-slug":"backlinks-authority"},{"name":"Advertising Intelligence","description":"Advertiser, audience, and advertising research APIs.","x-category-slug":"advertising-intelligence"}],"paths":{"/api/skill-api/v1/skills/design-similarity-search/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Design Similarity Search","description":"Search design registrations using one image URL or Base64 image, with optional region, source-jurisdiction, Locarno and legal-status filters. Results support candidate review and do not establish infringement or freedom to operate.","operationId":"runDesignSimilaritySearch","externalDocs":{"description":"Design Similarity Search documentation","url":"https://www.nexscope.ai/api-docs/design-similarity-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","oneOf":[{"required":["imageUrl"]},{"required":["imageBase64"]}],"properties":{"imageUrl":{"maxLength":4096,"format":"uri","pattern":"^https?://","type":"string","minLength":8},"imageBase64":{"maxLength":20971520,"type":"string","pattern":"^[A-Za-z0-9+/]+={0,2}$","minLength":16},"title":{"type":"string","maxLength":4096,"minLength":1},"topK":{"type":"integer","default":20,"maximum":200,"minimum":1},"regions":{"type":"array","items":{"pattern":"^[A-Za-z]{2}$","type":"string"},"uniqueItems":true,"maxItems":64},"jurisdictionCodes":{"type":"array","items":{"pattern":"^[A-Za-z]{2,8}$","type":"string"},"uniqueItems":true,"maxItems":32},"topLoc":{"type":"array","items":{"pattern":"^[0-9]{2}$","type":"string"},"uniqueItems":true,"maxItems":32},"locarnoClasses":{"type":"array","items":{"pattern":"^[0-9]{2}-[0-9]{2}$","type":"string"},"uniqueItems":true,"maxItems":64},"patentStatus":{"minItems":1,"uniqueItems":true,"type":"array","items":{"enum":[0,1],"type":"integer"},"maxItems":2}}},"example":{"topK":20,"title":"Bottle","imageUrl":"https://example.com/product.png"}}}},"responses":{"200":{"description":"Successful platform response. Missing source facts remain unknown.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","description":"Source envelope inside the gateway payload.","example":{},"properties":{"code":{"type":"string","description":"Success is OK. Errors include 400 DATA_IMAGE_DOWNLOAD_FAILED (no image substitution), 413 SYSTEM_PAYLOAD_TOO_LARGE (no automatic compression), 502 SR_QUERY_ERROR and 503 CAPABILITY_BACKEND_UNAVAILABLE (backend failure, not zero hits or insufficient credits). Preserve actual code and request identifiers; no automatic retries.","example":"OK"},"message":{"anyOf":[{"type":"string","description":"Source status message.","example":"success"},{"type":"null"}]},"request_id":{"anyOf":[{"type":"string","description":"Upstream request identifier; keep separate from requestId.","example":"req_example"},{"type":"null"}]},"data":{"type":"object","description":"Search result; preserve optional coverage and warnings when returned.","example":{},"properties":{"candidates":{"type":"array","description":"Candidates in returned order; empty is not freedom to operate.","example":[{"design_registration_id":"DSR:euipo_design:001694860-0001","registration_jurisdiction_code":"EU","jurisdiction_iso2":"EM","primary_identifier":"001694860-0001","application_number":"001694860","registration_number":"E077151-PC","publication_number":null,"title":"E077151-PC","title_language":"unknown","title_en":"Chairs [seats]","designer_names":null,"locarno_classes":["06.01"],"holder_names":["237302"],"simple_legal_status":"inactive","application_date":"2010-04-13","registration_date":null,"publication_date":null,"similarity":99.88,"risk_level":"medium","image_url":"https://example.com/design-1.png?signature=example%2Bsignature&expires=2000000000","images":["https://example.com/design-1.png?signature=example%2Bsignature&expires=2000000000","https://example.com/design-2.png?signature=second&expires=2000000000"],"specification":null,"novelty_statement":null,"applicant_addresses":null,"locarno_details":[{"code":"06.01","parent_code":"06","label_zh":null,"label_en":null}],"estimated_expiration_date":null,"expiration_date_basis":null,"tro_cases":[],"protected_jurisdictions":["EM"]}],"items":{"type":"object","properties":{"design_registration_id":{"anyOf":[{"type":"string","description":"Exact registration ID for details; preserve unchanged.","example":"DSR:euipo_design:001694860-0001"},{"type":"null"}]},"registration_jurisdiction_code":{"anyOf":[{"type":"string","description":"Source jurisdiction code such as EU, EMID or USID; do not rewrite as ISO-2.","example":"EU"},{"type":"null"}]},"jurisdiction_iso2":{"anyOf":[{"type":"string","description":"Registration jurisdiction, distinct from protected jurisdictions.","example":"EM"},{"type":"null"}]},"primary_identifier":{"anyOf":[{"type":"string","description":"Primary display number; retain leading zeros.","example":"001694860-0001"},{"type":"null"}]},"application_number":{"anyOf":[{"type":"string","description":"Source application number.","example":"001694860"},{"type":"null"}]},"registration_number":{"anyOf":[{"type":"string","description":"Source registration number.","example":"E077151-PC"},{"type":"null"}]},"publication_number":{"anyOf":[{"type":"string","description":"Source publication number; missing or null means unknown.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Source title, which may be a number.","example":"E077151-PC"},{"type":"null"}]},"title_language":{"anyOf":[{"type":"string","description":"Source title language; may be unknown.","example":"unknown"},{"type":"null"}]},"title_en":{"anyOf":[{"type":"string","description":"Source English title; do not translate missing values.","example":"Chairs [seats]"},{"type":"null"}]},"designer_names":{"anyOf":[{"type":"array","description":"Source designers; missing or null means unknown.","example":null},{"type":"null"}]},"locarno_classes":{"anyOf":[{"type":"array","description":"Preserve output codes such as 06.01 or 09-01; requests still require NN-NN.","example":["06.01"]},{"type":"null"}]},"holder_names":{"anyOf":[{"type":"array","description":"Source holders; do not resolve numeric identifiers to invented names.","example":["237302"]},{"type":"null"}]},"simple_legal_status":{"anyOf":[{"type":"string","description":"Source legal status; do not infer it from similarity.","example":"inactive"},{"type":"null"}]},"application_date":{"anyOf":[{"type":"string","description":"Source application date, YYYY-MM-DD.","example":"2010-04-13"},{"type":"null"}]},"registration_date":{"anyOf":[{"type":"string","description":"Source registration date, YYYY-MM-DD.","example":null},{"type":"null"}]},"publication_date":{"anyOf":[{"type":"string","description":"Source publication date, YYYY-MM-DD.","example":null},{"type":"null"}]},"similarity":{"anyOf":[{"type":"number","description":"Final 0-100 score, not a probability. Preserve returned order; never multiply by 100 or sort again.","example":99.88,"minimum":0,"maximum":100},{"type":"null"}]},"risk_level":{"anyOf":[{"type":"string","description":"Source risk hint, separate from score and legal status; not an infringement verdict.","example":"medium"},{"type":"null"}]},"image_url":{"anyOf":[{"type":"string","description":"Complete signed first-image URL; when images exist this equals images[0]. Never strip query parameters.","example":"https://example.com/design-1.png?signature=example%2Bsignature&expires=2000000000"},{"type":"null"}]},"images":{"anyOf":[{"type":"array","description":"At most six complete signed image URLs in original order; empty means no available images.","example":["https://example.com/design-1.png?signature=example%2Bsignature&expires=2000000000","https://example.com/design-2.png?signature=second&expires=2000000000"],"maxItems":6,"items":{"type":"string"}},{"type":"null"}]},"specification":{"anyOf":[{"type":["object","array","string","number","boolean","null"],"description":"Source JSON of any shape, or null; preserve actual structure without filling gaps.","example":null},{"type":"null"}]},"novelty_statement":{"anyOf":[{"type":"string","description":"Source novelty statement; retain original text, not a legal conclusion.","example":null},{"type":"null"}]},"applicant_addresses":{"anyOf":[{"type":"array","description":"Source applicant objects with name and address; never infer protection jurisdictions.","example":null,"items":{"type":"object","properties":{"name":{"type":"string","description":"Source applicant name.","example":"Example applicant"},"address":{"type":"string","description":"Source address; not evidence of protected jurisdiction.","example":"Example address"}}}},{"type":"null"}]},"locarno_details":{"anyOf":[{"type":"array","description":"Source code, parent_code, label_zh and label_en; missing labels stay unknown.","example":[{"code":"06.01","parent_code":"06","label_zh":null,"label_en":null}],"items":{"type":"object","properties":{"code":{"type":"string","description":"Unmodified source classification code.","example":"06.01"},"parent_code":{"type":"string","description":"Source parent classification.","example":"06"},"label_zh":{"type":"string","description":"Source Chinese label; missing/null stays unknown.","example":null},"label_en":{"type":"string","description":"Source English label; missing/null stays unknown.","example":null}}}},{"type":"null"}]},"estimated_expiration_date":{"anyOf":[{"type":"string","description":"Estimated date only, YYYY-MM-DD; not confirmed expiry or invalidity.","example":null},{"type":"null"}]},"expiration_date_basis":{"anyOf":[{"type":["object","array","string","number","boolean","null"],"description":"Source JSON of any shape, or null; never invent an estimation basis.","example":null},{"type":"null"}]},"tro_cases":{"anyOf":[{"type":"array","description":"Current TRO corpus associations; empty is not confirmation of no TRO.","example":[]},{"type":"null"}]},"protected_jurisdictions":{"anyOf":[{"type":"array","description":"HAGUE designated states or ordinary registration jurisdiction; null means unknown, never fill from regions.","example":["EM"]},{"type":"null"}]}}}},"total":{"anyOf":[{"type":"integer","description":"Returned candidate count, not corpus size or user billing units.","example":1},{"type":"null"}]},"coverage":{"anyOf":[{"type":"object","description":"Optional source coverage; do not infer completeness.","example":{}},{"type":"null"}]},"warnings":{"anyOf":[{"type":"array","description":"Optional source limitations.","example":[]},{"type":"null"}]}},"required":["candidates"]},"usage":{"anyOf":[{"type":"object","description":"Source-account usage; not user debit or balance.","example":{}},{"type":"null"}]}},"required":["code","data"]},"upstreamRequestId":{"anyOf":[{"type":"string","description":"Extracted upstream request identifier.","example":"req_example"},{"type":"null"}]},"requestId":{"anyOf":[{"type":"string","description":"Gateway/service error request identifier; distinct from upstream request_id.","example":"gateway_example"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":["data"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"request_id":"req_example","data":{"total":1,"candidates":[{"design_registration_id":"DSR:euipo_design:001694860-0001","registration_jurisdiction_code":"EU","jurisdiction_iso2":"EM","primary_identifier":"001694860-0001","application_number":"001694860","registration_number":"E077151-PC","publication_number":null,"title":"E077151-PC","title_language":"unknown","title_en":"Chairs [seats]","designer_names":null,"locarno_classes":["06.01"],"holder_names":["237302"],"simple_legal_status":"inactive","application_date":"2010-04-13","registration_date":null,"publication_date":null,"similarity":99.88,"risk_level":"medium","image_url":"https://example.com/design-1.png?signature=example%2Bsignature&expires=2000000000","images":["https://example.com/design-1.png?signature=example%2Bsignature&expires=2000000000","https://example.com/design-2.png?signature=second&expires=2000000000"],"specification":null,"novelty_statement":null,"applicant_addresses":null,"locarno_details":[{"code":"06.01","parent_code":"06","label_zh":null,"label_en":null}],"estimated_expiration_date":null,"expiration_date_basis":null,"tro_cases":[],"protected_jurisdictions":["EM"]}]},"message":"success","code":"OK"}},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"design-similarity-search","x-nexscope-mcp-tool-name":"nexscope_design_similarity_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/ai/designSimilaritySearch":{"post":{"tags":["Patent & IP Risk"],"summary":"Design Similarity Search","description":"Search design registrations using one image URL or Base64 image, with optional region, source-jurisdiction, Locarno and legal-status filters. Results support candidate review and do not establish infringement or freedom to operate.","operationId":"runDesignSimilaritySearchShort","externalDocs":{"description":"Design Similarity Search documentation","url":"https://www.nexscope.ai/api-docs/design-similarity-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","oneOf":[{"required":["imageUrl"]},{"required":["imageBase64"]}],"properties":{"imageUrl":{"maxLength":4096,"format":"uri","pattern":"^https?://","type":"string","minLength":8},"imageBase64":{"maxLength":20971520,"type":"string","pattern":"^[A-Za-z0-9+/]+={0,2}$","minLength":16},"title":{"type":"string","maxLength":4096,"minLength":1},"topK":{"type":"integer","default":20,"maximum":200,"minimum":1},"regions":{"type":"array","items":{"pattern":"^[A-Za-z]{2}$","type":"string"},"uniqueItems":true,"maxItems":64},"jurisdictionCodes":{"type":"array","items":{"pattern":"^[A-Za-z]{2,8}$","type":"string"},"uniqueItems":true,"maxItems":32},"topLoc":{"type":"array","items":{"pattern":"^[0-9]{2}$","type":"string"},"uniqueItems":true,"maxItems":32},"locarnoClasses":{"type":"array","items":{"pattern":"^[0-9]{2}-[0-9]{2}$","type":"string"},"uniqueItems":true,"maxItems":64},"patentStatus":{"minItems":1,"uniqueItems":true,"type":"array","items":{"enum":[0,1],"type":"integer"},"maxItems":2}}},"example":{"topK":20,"title":"Bottle","imageUrl":"https://example.com/product.png"}}}},"responses":{"200":{"description":"Successful platform response. Missing source facts remain unknown.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","description":"Source envelope inside the gateway payload.","example":{},"properties":{"code":{"type":"string","description":"Success is OK. Errors include 400 DATA_IMAGE_DOWNLOAD_FAILED (no image substitution), 413 SYSTEM_PAYLOAD_TOO_LARGE (no automatic compression), 502 SR_QUERY_ERROR and 503 CAPABILITY_BACKEND_UNAVAILABLE (backend failure, not zero hits or insufficient credits). Preserve actual code and request identifiers; no automatic retries.","example":"OK"},"message":{"anyOf":[{"type":"string","description":"Source status message.","example":"success"},{"type":"null"}]},"request_id":{"anyOf":[{"type":"string","description":"Upstream request identifier; keep separate from requestId.","example":"req_example"},{"type":"null"}]},"data":{"type":"object","description":"Search result; preserve optional coverage and warnings when returned.","example":{},"properties":{"candidates":{"type":"array","description":"Candidates in returned order; empty is not freedom to operate.","example":[{"design_registration_id":"DSR:euipo_design:001694860-0001","registration_jurisdiction_code":"EU","jurisdiction_iso2":"EM","primary_identifier":"001694860-0001","application_number":"001694860","registration_number":"E077151-PC","publication_number":null,"title":"E077151-PC","title_language":"unknown","title_en":"Chairs [seats]","designer_names":null,"locarno_classes":["06.01"],"holder_names":["237302"],"simple_legal_status":"inactive","application_date":"2010-04-13","registration_date":null,"publication_date":null,"similarity":99.88,"risk_level":"medium","image_url":"https://example.com/design-1.png?signature=example%2Bsignature&expires=2000000000","images":["https://example.com/design-1.png?signature=example%2Bsignature&expires=2000000000","https://example.com/design-2.png?signature=second&expires=2000000000"],"specification":null,"novelty_statement":null,"applicant_addresses":null,"locarno_details":[{"code":"06.01","parent_code":"06","label_zh":null,"label_en":null}],"estimated_expiration_date":null,"expiration_date_basis":null,"tro_cases":[],"protected_jurisdictions":["EM"]}],"items":{"type":"object","properties":{"design_registration_id":{"anyOf":[{"type":"string","description":"Exact registration ID for details; preserve unchanged.","example":"DSR:euipo_design:001694860-0001"},{"type":"null"}]},"registration_jurisdiction_code":{"anyOf":[{"type":"string","description":"Source jurisdiction code such as EU, EMID or USID; do not rewrite as ISO-2.","example":"EU"},{"type":"null"}]},"jurisdiction_iso2":{"anyOf":[{"type":"string","description":"Registration jurisdiction, distinct from protected jurisdictions.","example":"EM"},{"type":"null"}]},"primary_identifier":{"anyOf":[{"type":"string","description":"Primary display number; retain leading zeros.","example":"001694860-0001"},{"type":"null"}]},"application_number":{"anyOf":[{"type":"string","description":"Source application number.","example":"001694860"},{"type":"null"}]},"registration_number":{"anyOf":[{"type":"string","description":"Source registration number.","example":"E077151-PC"},{"type":"null"}]},"publication_number":{"anyOf":[{"type":"string","description":"Source publication number; missing or null means unknown.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Source title, which may be a number.","example":"E077151-PC"},{"type":"null"}]},"title_language":{"anyOf":[{"type":"string","description":"Source title language; may be unknown.","example":"unknown"},{"type":"null"}]},"title_en":{"anyOf":[{"type":"string","description":"Source English title; do not translate missing values.","example":"Chairs [seats]"},{"type":"null"}]},"designer_names":{"anyOf":[{"type":"array","description":"Source designers; missing or null means unknown.","example":null},{"type":"null"}]},"locarno_classes":{"anyOf":[{"type":"array","description":"Preserve output codes such as 06.01 or 09-01; requests still require NN-NN.","example":["06.01"]},{"type":"null"}]},"holder_names":{"anyOf":[{"type":"array","description":"Source holders; do not resolve numeric identifiers to invented names.","example":["237302"]},{"type":"null"}]},"simple_legal_status":{"anyOf":[{"type":"string","description":"Source legal status; do not infer it from similarity.","example":"inactive"},{"type":"null"}]},"application_date":{"anyOf":[{"type":"string","description":"Source application date, YYYY-MM-DD.","example":"2010-04-13"},{"type":"null"}]},"registration_date":{"anyOf":[{"type":"string","description":"Source registration date, YYYY-MM-DD.","example":null},{"type":"null"}]},"publication_date":{"anyOf":[{"type":"string","description":"Source publication date, YYYY-MM-DD.","example":null},{"type":"null"}]},"similarity":{"anyOf":[{"type":"number","description":"Final 0-100 score, not a probability. Preserve returned order; never multiply by 100 or sort again.","example":99.88,"minimum":0,"maximum":100},{"type":"null"}]},"risk_level":{"anyOf":[{"type":"string","description":"Source risk hint, separate from score and legal status; not an infringement verdict.","example":"medium"},{"type":"null"}]},"image_url":{"anyOf":[{"type":"string","description":"Complete signed first-image URL; when images exist this equals images[0]. Never strip query parameters.","example":"https://example.com/design-1.png?signature=example%2Bsignature&expires=2000000000"},{"type":"null"}]},"images":{"anyOf":[{"type":"array","description":"At most six complete signed image URLs in original order; empty means no available images.","example":["https://example.com/design-1.png?signature=example%2Bsignature&expires=2000000000","https://example.com/design-2.png?signature=second&expires=2000000000"],"maxItems":6,"items":{"type":"string"}},{"type":"null"}]},"specification":{"anyOf":[{"type":["object","array","string","number","boolean","null"],"description":"Source JSON of any shape, or null; preserve actual structure without filling gaps.","example":null},{"type":"null"}]},"novelty_statement":{"anyOf":[{"type":"string","description":"Source novelty statement; retain original text, not a legal conclusion.","example":null},{"type":"null"}]},"applicant_addresses":{"anyOf":[{"type":"array","description":"Source applicant objects with name and address; never infer protection jurisdictions.","example":null,"items":{"type":"object","properties":{"name":{"type":"string","description":"Source applicant name.","example":"Example applicant"},"address":{"type":"string","description":"Source address; not evidence of protected jurisdiction.","example":"Example address"}}}},{"type":"null"}]},"locarno_details":{"anyOf":[{"type":"array","description":"Source code, parent_code, label_zh and label_en; missing labels stay unknown.","example":[{"code":"06.01","parent_code":"06","label_zh":null,"label_en":null}],"items":{"type":"object","properties":{"code":{"type":"string","description":"Unmodified source classification code.","example":"06.01"},"parent_code":{"type":"string","description":"Source parent classification.","example":"06"},"label_zh":{"type":"string","description":"Source Chinese label; missing/null stays unknown.","example":null},"label_en":{"type":"string","description":"Source English label; missing/null stays unknown.","example":null}}}},{"type":"null"}]},"estimated_expiration_date":{"anyOf":[{"type":"string","description":"Estimated date only, YYYY-MM-DD; not confirmed expiry or invalidity.","example":null},{"type":"null"}]},"expiration_date_basis":{"anyOf":[{"type":["object","array","string","number","boolean","null"],"description":"Source JSON of any shape, or null; never invent an estimation basis.","example":null},{"type":"null"}]},"tro_cases":{"anyOf":[{"type":"array","description":"Current TRO corpus associations; empty is not confirmation of no TRO.","example":[]},{"type":"null"}]},"protected_jurisdictions":{"anyOf":[{"type":"array","description":"HAGUE designated states or ordinary registration jurisdiction; null means unknown, never fill from regions.","example":["EM"]},{"type":"null"}]}}}},"total":{"anyOf":[{"type":"integer","description":"Returned candidate count, not corpus size or user billing units.","example":1},{"type":"null"}]},"coverage":{"anyOf":[{"type":"object","description":"Optional source coverage; do not infer completeness.","example":{}},{"type":"null"}]},"warnings":{"anyOf":[{"type":"array","description":"Optional source limitations.","example":[]},{"type":"null"}]}},"required":["candidates"]},"usage":{"anyOf":[{"type":"object","description":"Source-account usage; not user debit or balance.","example":{}},{"type":"null"}]}},"required":["code","data"]},"upstreamRequestId":{"anyOf":[{"type":"string","description":"Extracted upstream request identifier.","example":"req_example"},{"type":"null"}]},"requestId":{"anyOf":[{"type":"string","description":"Gateway/service error request identifier; distinct from upstream request_id.","example":"gateway_example"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":["data"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"request_id":"req_example","data":{"total":1,"candidates":[{"design_registration_id":"DSR:euipo_design:001694860-0001","registration_jurisdiction_code":"EU","jurisdiction_iso2":"EM","primary_identifier":"001694860-0001","application_number":"001694860","registration_number":"E077151-PC","publication_number":null,"title":"E077151-PC","title_language":"unknown","title_en":"Chairs [seats]","designer_names":null,"locarno_classes":["06.01"],"holder_names":["237302"],"simple_legal_status":"inactive","application_date":"2010-04-13","registration_date":null,"publication_date":null,"similarity":99.88,"risk_level":"medium","image_url":"https://example.com/design-1.png?signature=example%2Bsignature&expires=2000000000","images":["https://example.com/design-1.png?signature=example%2Bsignature&expires=2000000000","https://example.com/design-2.png?signature=second&expires=2000000000"],"specification":null,"novelty_statement":null,"applicant_addresses":null,"locarno_details":[{"code":"06.01","parent_code":"06","label_zh":null,"label_en":null}],"estimated_expiration_date":null,"expiration_date_basis":null,"tro_cases":[],"protected_jurisdictions":["EM"]}]},"message":"success","code":"OK"}},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"design-similarity-search","x-nexscope-mcp-tool-name":"nexscope_design_similarity_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/design-registration-details/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Design Registration Details","description":"Retrieve design-registration holders, designers, legal status, dates and classifications by exact identifiers. Results support candidate review, not an infringement verdict.","operationId":"runDesignRegistrationDetails","externalDocs":{"description":"Design Registration Details documentation","url":"https://www.nexscope.ai/api-docs/design-registration-details"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","oneOf":[{"not":{"anyOf":[{"required":["primaryIdentifier"]},{"required":["jurisdictionIso2"]}]},"required":["designRegistrationIds"]},{"not":{"required":["designRegistrationIds"]},"required":["primaryIdentifier"]}],"properties":{"jurisdictionIso2":{"pattern":"^[A-Za-z]{2}$","type":"string"},"primaryIdentifier":{"maxLength":128,"type":"string","pattern":"^\\S(?:[^\\r\\n]*\\S)?$","minLength":1},"designRegistrationIds":{"minItems":1,"uniqueItems":true,"type":"array","items":{"maxLength":128,"type":"string","pattern":"^\\S(?:[^\\r\\n]*\\S)?$","minLength":1},"maxItems":200}}},"example":{"designRegistrationIds":["DSR:wipo_hague:EMID.001431738-0001"]}}}},"responses":{"200":{"description":"Successful platform response. Missing source facts remain unknown.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","description":"Source envelope retained within the gateway payload.","example":{},"properties":{"code":{"type":"string","description":"Success is OK. DATA_DESIGN_NOT_FOUND (404) means no source detail found, not absence of rights. Preserve actual source/configuration errors and request identifiers; do not retry, split or change lookup mode automatically. Authentication, credits and permission failures remain distinct.","example":"OK"},"request_id":{"anyOf":[{"type":"string","description":"Source request identifier.","example":"example-request"},{"type":"null"}]},"data":{"type":"object","description":"Registration details result.","example":{},"properties":{"returned":{"anyOf":[{"type":"integer","description":"Number of returned records, not dataset size.","example":1},{"type":"null"}]},"items":{"type":"array","description":"All returned registration records in source order; no infringement conclusion.","example":[{"holder_names":["Example holder"],"designer_names":["Example designer"],"title_en":"Bottles","has_readable_image":1,"image_count":5,"primary_identifier":"001431738","simple_legal_status":"inactive","design_registration_id":"DSR:wipo_hague:EMID.001431738-0001","as_of_date":"2026-10-09"}],"items":{"type":"object","properties":{"design_registration_id":{"anyOf":[{"type":"string","description":"Exact registration ID.","example":"DSR:wipo_hague:EMID.001431738-0001"},{"type":"null"}]},"primary_identifier":{"anyOf":[{"type":"string","description":"Primary number; preserve leading zeros.","example":"001431738"},{"type":"null"}]},"holder_names":{"anyOf":[{"type":"array","description":"Source holders, when known.","example":["Example holder"]},{"type":"null"}]},"designer_names":{"anyOf":[{"type":"array","description":"Source designers, when known.","example":["Example designer"]},{"type":"null"}]},"simple_legal_status":{"anyOf":[{"type":"string","description":"Source legal status; do not infer missing values.","example":"inactive"},{"type":"null"}]},"as_of_date":{"anyOf":[{"type":"string","description":"Source confirmation date, not necessarily today.","example":"2026-10-09"},{"type":"null"}]},"has_readable_image":{"anyOf":[{"type":"integer","description":"Source media hint; not an image URL.","example":1},{"type":"null"}]},"image_count":{"anyOf":[{"type":"integer","description":"Source image count; do not construct download links.","example":5},{"type":"null"}]},"application_number":{"anyOf":[{"type":"string","description":"Source application number; preserve leading zeros.","example":"example-application"},{"type":"null"}]},"registration_number":{"anyOf":[{"type":"string","description":"Source registration number, not a constructed registration ID.","example":"example-registration"},{"type":"null"}]},"publication_number":{"anyOf":[{"type":"string","description":"Source publication number.","example":"example-publication"},{"type":"null"}]},"data_version":{"anyOf":[{"type":"string","description":"Source data version.","example":"example-version"},{"type":"null"}]},"right_type":{"anyOf":[{"type":"string","description":"Source right type.","example":"registered_design"},{"type":"null"}]},"registration_jurisdiction":{"anyOf":[{"type":"string","description":"Original source jurisdiction value.","example":"EM"},{"type":"null"}]},"registration_jurisdiction_code":{"anyOf":[{"type":"string","description":"Original source jurisdiction code.","example":"EMID"},{"type":"null"}]},"jurisdiction_iso2":{"anyOf":[{"type":"string","description":"Two-letter jurisdiction; EM represents the EU.","example":"EM"},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Original source title.","example":"Bottles"},{"type":"null"}]},"title_language":{"anyOf":[{"type":"string","description":"Source title language; may be unknown.","example":"unknown"},{"type":"null"}]},"title_en":{"anyOf":[{"type":"string","description":"Source English title; do not translate independently.","example":"Bottles"},{"type":"null"}]},"title_en_source":{"anyOf":[{"type":"string","description":"Provenance of the English title.","example":"source"},{"type":"null"}]},"raw_status":{"anyOf":[{"type":"string","description":"Unmapped original source status.","example":"DEL"},{"type":"null"}]},"application_date":{"anyOf":[{"type":"string","description":"Application date, YYYY-MM-DD.","example":"2020-01-01"},{"type":"null"}]},"registration_date":{"anyOf":[{"type":"string","description":"Registration date, YYYY-MM-DD.","example":"2020-02-01"},{"type":"null"}]},"publication_date":{"anyOf":[{"type":"string","description":"Publication date, YYYY-MM-DD.","example":"2020-03-01"},{"type":"null"}]},"data_quality_level":{"anyOf":[{"type":"string","description":"Source data quality level; absent means unknown.","example":"usable"},{"type":"null"}]},"coverage_level":{"anyOf":[{"type":"string","description":"Source coverage level; no completeness guarantee.","example":"detail_ready"},{"type":"null"}]},"classification_count":{"anyOf":[{"type":"integer","description":"Source fact count; missing values remain unknown.","example":1},{"type":"null"}]},"party_count":{"anyOf":[{"type":"integer","description":"Source fact count; missing values remain unknown.","example":1},{"type":"null"}]},"text_count":{"anyOf":[{"type":"integer","description":"Source fact count; missing values remain unknown.","example":1},{"type":"null"}]},"locarno_classes":{"anyOf":[{"type":"array","description":"Source Locarno classes; preserve leading zeros.","example":["09-01"]},{"type":"null"}]}}}},"asset":{"anyOf":[{"type":"string","description":"Source asset identifier.","example":"asset.design_profile"},{"type":"null"}]},"asset_code":{"anyOf":[{"type":"string","description":"Source asset code.","example":"asset_ipr_design_profile"},{"type":"null"}]},"execution":{"anyOf":[{"type":"object","description":"Optional source execution metadata.","example":{}},{"type":"null"}]}},"required":["items"]},"message":{"anyOf":[{"type":"string","description":"Source status message.","example":"success"},{"type":"null"}]},"usage":{"anyOf":[{"type":"object","description":"Raw source usage, not user billing or balance.","example":{}},{"type":"null"}]}},"required":["code","data"]},"requestId":{"anyOf":[{"type":"string","description":"Gateway/service error request identifier, distinct from upstream request_id.","example":"gateway_example"},{"type":"null"}]},"upstreamRequestId":{"anyOf":[{"type":"string","description":"Extracted upstream request identifier.","example":"req_example"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":["data"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"data":{"items":[{"holder_names":["Example holder"],"designer_names":["Example designer"],"title_en":"Bottles","has_readable_image":1,"image_count":5,"primary_identifier":"001431738","simple_legal_status":"inactive","design_registration_id":"DSR:wipo_hague:EMID.001431738-0001","as_of_date":"2026-10-09"}],"returned":1},"request_id":"example-request","code":"OK"}},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"design-registration-details","x-nexscope-mcp-tool-name":"nexscope_design_registration_details","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/ai/designRegistrationDetails":{"post":{"tags":["Patent & IP Risk"],"summary":"Design Registration Details","description":"Retrieve design-registration holders, designers, legal status, dates and classifications by exact identifiers. Results support candidate review, not an infringement verdict.","operationId":"runDesignRegistrationDetailsShort","externalDocs":{"description":"Design Registration Details documentation","url":"https://www.nexscope.ai/api-docs/design-registration-details"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","oneOf":[{"not":{"anyOf":[{"required":["primaryIdentifier"]},{"required":["jurisdictionIso2"]}]},"required":["designRegistrationIds"]},{"not":{"required":["designRegistrationIds"]},"required":["primaryIdentifier"]}],"properties":{"jurisdictionIso2":{"pattern":"^[A-Za-z]{2}$","type":"string"},"primaryIdentifier":{"maxLength":128,"type":"string","pattern":"^\\S(?:[^\\r\\n]*\\S)?$","minLength":1},"designRegistrationIds":{"minItems":1,"uniqueItems":true,"type":"array","items":{"maxLength":128,"type":"string","pattern":"^\\S(?:[^\\r\\n]*\\S)?$","minLength":1},"maxItems":200}}},"example":{"designRegistrationIds":["DSR:wipo_hague:EMID.001431738-0001"]}}}},"responses":{"200":{"description":"Successful platform response. Missing source facts remain unknown.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"type":"object","description":"Source envelope retained within the gateway payload.","example":{},"properties":{"code":{"type":"string","description":"Success is OK. DATA_DESIGN_NOT_FOUND (404) means no source detail found, not absence of rights. Preserve actual source/configuration errors and request identifiers; do not retry, split or change lookup mode automatically. Authentication, credits and permission failures remain distinct.","example":"OK"},"request_id":{"anyOf":[{"type":"string","description":"Source request identifier.","example":"example-request"},{"type":"null"}]},"data":{"type":"object","description":"Registration details result.","example":{},"properties":{"returned":{"anyOf":[{"type":"integer","description":"Number of returned records, not dataset size.","example":1},{"type":"null"}]},"items":{"type":"array","description":"All returned registration records in source order; no infringement conclusion.","example":[{"holder_names":["Example holder"],"designer_names":["Example designer"],"title_en":"Bottles","has_readable_image":1,"image_count":5,"primary_identifier":"001431738","simple_legal_status":"inactive","design_registration_id":"DSR:wipo_hague:EMID.001431738-0001","as_of_date":"2026-10-09"}],"items":{"type":"object","properties":{"design_registration_id":{"anyOf":[{"type":"string","description":"Exact registration ID.","example":"DSR:wipo_hague:EMID.001431738-0001"},{"type":"null"}]},"primary_identifier":{"anyOf":[{"type":"string","description":"Primary number; preserve leading zeros.","example":"001431738"},{"type":"null"}]},"holder_names":{"anyOf":[{"type":"array","description":"Source holders, when known.","example":["Example holder"]},{"type":"null"}]},"designer_names":{"anyOf":[{"type":"array","description":"Source designers, when known.","example":["Example designer"]},{"type":"null"}]},"simple_legal_status":{"anyOf":[{"type":"string","description":"Source legal status; do not infer missing values.","example":"inactive"},{"type":"null"}]},"as_of_date":{"anyOf":[{"type":"string","description":"Source confirmation date, not necessarily today.","example":"2026-10-09"},{"type":"null"}]},"has_readable_image":{"anyOf":[{"type":"integer","description":"Source media hint; not an image URL.","example":1},{"type":"null"}]},"image_count":{"anyOf":[{"type":"integer","description":"Source image count; do not construct download links.","example":5},{"type":"null"}]},"application_number":{"anyOf":[{"type":"string","description":"Source application number; preserve leading zeros.","example":"example-application"},{"type":"null"}]},"registration_number":{"anyOf":[{"type":"string","description":"Source registration number, not a constructed registration ID.","example":"example-registration"},{"type":"null"}]},"publication_number":{"anyOf":[{"type":"string","description":"Source publication number.","example":"example-publication"},{"type":"null"}]},"data_version":{"anyOf":[{"type":"string","description":"Source data version.","example":"example-version"},{"type":"null"}]},"right_type":{"anyOf":[{"type":"string","description":"Source right type.","example":"registered_design"},{"type":"null"}]},"registration_jurisdiction":{"anyOf":[{"type":"string","description":"Original source jurisdiction value.","example":"EM"},{"type":"null"}]},"registration_jurisdiction_code":{"anyOf":[{"type":"string","description":"Original source jurisdiction code.","example":"EMID"},{"type":"null"}]},"jurisdiction_iso2":{"anyOf":[{"type":"string","description":"Two-letter jurisdiction; EM represents the EU.","example":"EM"},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Original source title.","example":"Bottles"},{"type":"null"}]},"title_language":{"anyOf":[{"type":"string","description":"Source title language; may be unknown.","example":"unknown"},{"type":"null"}]},"title_en":{"anyOf":[{"type":"string","description":"Source English title; do not translate independently.","example":"Bottles"},{"type":"null"}]},"title_en_source":{"anyOf":[{"type":"string","description":"Provenance of the English title.","example":"source"},{"type":"null"}]},"raw_status":{"anyOf":[{"type":"string","description":"Unmapped original source status.","example":"DEL"},{"type":"null"}]},"application_date":{"anyOf":[{"type":"string","description":"Application date, YYYY-MM-DD.","example":"2020-01-01"},{"type":"null"}]},"registration_date":{"anyOf":[{"type":"string","description":"Registration date, YYYY-MM-DD.","example":"2020-02-01"},{"type":"null"}]},"publication_date":{"anyOf":[{"type":"string","description":"Publication date, YYYY-MM-DD.","example":"2020-03-01"},{"type":"null"}]},"data_quality_level":{"anyOf":[{"type":"string","description":"Source data quality level; absent means unknown.","example":"usable"},{"type":"null"}]},"coverage_level":{"anyOf":[{"type":"string","description":"Source coverage level; no completeness guarantee.","example":"detail_ready"},{"type":"null"}]},"classification_count":{"anyOf":[{"type":"integer","description":"Source fact count; missing values remain unknown.","example":1},{"type":"null"}]},"party_count":{"anyOf":[{"type":"integer","description":"Source fact count; missing values remain unknown.","example":1},{"type":"null"}]},"text_count":{"anyOf":[{"type":"integer","description":"Source fact count; missing values remain unknown.","example":1},{"type":"null"}]},"locarno_classes":{"anyOf":[{"type":"array","description":"Source Locarno classes; preserve leading zeros.","example":["09-01"]},{"type":"null"}]}}}},"asset":{"anyOf":[{"type":"string","description":"Source asset identifier.","example":"asset.design_profile"},{"type":"null"}]},"asset_code":{"anyOf":[{"type":"string","description":"Source asset code.","example":"asset_ipr_design_profile"},{"type":"null"}]},"execution":{"anyOf":[{"type":"object","description":"Optional source execution metadata.","example":{}},{"type":"null"}]}},"required":["items"]},"message":{"anyOf":[{"type":"string","description":"Source status message.","example":"success"},{"type":"null"}]},"usage":{"anyOf":[{"type":"object","description":"Raw source usage, not user billing or balance.","example":{}},{"type":"null"}]}},"required":["code","data"]},"requestId":{"anyOf":[{"type":"string","description":"Gateway/service error request identifier, distinct from upstream request_id.","example":"gateway_example"},{"type":"null"}]},"upstreamRequestId":{"anyOf":[{"type":"string","description":"Extracted upstream request identifier.","example":"req_example"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":["data"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"data":{"items":[{"holder_names":["Example holder"],"designer_names":["Example designer"],"title_en":"Bottles","has_readable_image":1,"image_count":5,"primary_identifier":"001431738","simple_legal_status":"inactive","design_registration_id":"DSR:wipo_hague:EMID.001431738-0001","as_of_date":"2026-10-09"}],"returned":1},"request_id":"example-request","code":"OK"}},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"design-registration-details","x-nexscope-mcp-tool-name":"nexscope_design_registration_details","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-ads-sp-insights-report-download/run":{"post":{"tags":["Amazon Advertising"],"summary":"Amazon Ads SP Insights Report Download","description":"Uses existing Amazon Ads authorization and tokenized download handling. Create once, poll by reportId, then download using a documentToken.","operationId":"runAmazonAdsSpInsightsReportDownload","externalDocs":{"description":"Amazon Ads SP Insights Report Download documentation","url":"https://www.nexscope.ai/api-docs/amazon-ads-sp-insights-report-download"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["connectionId","documentToken"],"additionalProperties":false,"properties":{"connectionId":{"minimum":1,"type":"integer"},"documentToken":{"type":"string","minLength":1}},"type":"object"},"example":{"connectionId":123,"documentToken":"opaque-document-token"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"contentType":{"anyOf":[{"type":"string","description":"Downloaded media type","example":"text/csv"},{"type":"null"}]},"content":{"anyOf":[{"type":"string","description":"UTF-8 CSV report content","example":"date.value,metric.impressions\n2026-08-01,10\n"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"content":"date.value,metric.impressions\n2026-08-01,10\n","contentType":"text/csv"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-ads-sp-insights-report-download","x-nexscope-mcp-tool-name":"nexscope_amazon_ads_sp_insights_report_download","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-ads-sp-insights-report-status/run":{"post":{"tags":["Amazon Advertising"],"summary":"Amazon Ads SP Insights Report Status","description":"Uses existing Amazon Ads authorization and tokenized download handling. Create once, poll by reportId, then download using a documentToken.","operationId":"runAmazonAdsSpInsightsReportStatus","externalDocs":{"description":"Amazon Ads SP Insights Report Status documentation","url":"https://www.nexscope.ai/api-docs/amazon-ads-sp-insights-report-status"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["connectionId","reportId"],"additionalProperties":false,"properties":{"connectionId":{"minimum":1,"type":"integer"},"reportId":{"type":"string","minLength":1}},"type":"object"},"example":{"connectionId":123,"reportId":"report-id"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"reportId":{"type":"string","description":"Created or queried report identifier.","example":"report-id"},"status":{"anyOf":[{"type":"string","description":"Provider report state when present.","example":"PENDING"},{"type":"null"}]},"completedReportParts":{"anyOf":[{"type":"array","description":"Completed CSV parts; each part contains a backend documentToken instead of a signed URL.","example":[]},{"type":"null"}]},"reportParts":{"anyOf":[{"type":"array","description":"Provider alias for completed parts, when present.","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":["reportId"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reportId":"report-id","status":"PENDING"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-ads-sp-insights-report-status","x-nexscope-mcp-tool-name":"nexscope_amazon_ads_sp_insights_report_status","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-ads-sp-search-impression-share-report/run":{"post":{"tags":["Amazon Advertising"],"summary":"Amazon Ads SP Search Impression Share Report","description":"Uses existing Amazon Ads authorization and tokenized download handling. Create once, poll by reportId, then download using a documentToken.","operationId":"runAmazonAdsSpSearchImpressionShareReport","externalDocs":{"description":"Amazon Ads SP Search Impression Share Report documentation","url":"https://www.nexscope.ai/api-docs/amazon-ads-sp-search-impression-share-report"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["connectionId","startDate","endDate"],"additionalProperties":false,"properties":{"connectionId":{"minimum":1,"type":"integer"},"startDate":{"format":"date","type":"string"},"endDate":{"format":"date","type":"string"},"advertiserAccountId":{"type":"string","minLength":1},"timeUnit":{"enum":["DAILY","SUMMARY"],"default":"DAILY","type":"string"}},"type":"object"},"example":{"connectionId":123,"startDate":"2026-08-01","endDate":"2026-08-07"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"reportId":{"type":"string","description":"Created or queried report identifier.","example":"report-id"},"status":{"anyOf":[{"type":"string","description":"Provider report state when present.","example":"PENDING"},{"type":"null"}]},"completedReportParts":{"anyOf":[{"type":"array","description":"Completed CSV parts; each part contains a backend documentToken instead of a signed URL.","example":[]},{"type":"null"}]},"reportParts":{"anyOf":[{"type":"array","description":"Provider alias for completed parts, when present.","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":["reportId"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reportId":"report-id","status":"PENDING"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-ads-sp-search-impression-share-report","x-nexscope-mcp-tool-name":"nexscope_amazon_ads_sp_search_impression_share_report","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-ads-sp-audience-report/run":{"post":{"tags":["Amazon Advertising"],"summary":"Amazon Ads SP Audience Report","description":"Uses existing Amazon Ads authorization and tokenized download handling. Create once, poll by reportId, then download using a documentToken.","operationId":"runAmazonAdsSpAudienceReport","externalDocs":{"description":"Amazon Ads SP Audience Report documentation","url":"https://www.nexscope.ai/api-docs/amazon-ads-sp-audience-report"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["connectionId","startDate","endDate"],"additionalProperties":false,"properties":{"connectionId":{"minimum":1,"type":"integer"},"startDate":{"format":"date","type":"string"},"endDate":{"format":"date","type":"string"},"advertiserAccountId":{"type":"string","minLength":1},"timeUnit":{"enum":["DAILY","SUMMARY"],"default":"DAILY","type":"string"},"detailLevel":{"enum":["ACCOUNT","CAMPAIGN","AD_GROUP"],"default":"ACCOUNT","type":"string"}},"type":"object"},"example":{"connectionId":123,"startDate":"2026-08-01","endDate":"2026-08-07"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"reportId":{"type":"string","description":"Created or queried report identifier.","example":"report-id"},"status":{"anyOf":[{"type":"string","description":"Provider report state when present.","example":"PENDING"},{"type":"null"}]},"completedReportParts":{"anyOf":[{"type":"array","description":"Completed CSV parts; each part contains a backend documentToken instead of a signed URL.","example":[]},{"type":"null"}]},"reportParts":{"anyOf":[{"type":"array","description":"Provider alias for completed parts, when present.","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":["reportId"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reportId":"report-id","status":"PENDING"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-ads-sp-audience-report","x-nexscope-mcp-tool-name":"nexscope_amazon_ads_sp_audience_report","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-creative-detail/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Creative Detail","description":"TikTok Creative Detail. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.","operationId":"runChuhaijiangTiktokCreativeDetail","externalDocs":{"description":"Nexscope TikTok Creative Detail documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creative-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["country","id"],"additionalProperties":false,"properties":{"country":{"enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"type":"string","description":"Lowercase request market. Returned country_code may differ; preserve both."},"id":{"minLength":1,"type":"string","description":"Creative ID returned by its search operation. Keep identifiers as strings to avoid precision loss."},"include":{"pattern":"^(analysis|embedding)(,(analysis|embedding))*$","type":"string","description":"Comma-separated expansions: analysis, embedding. Request only needed expansions."}},"type":"object"},"example":{"include":"analysis,embedding","country":"us","id":"7668708053428047118"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"data":{"type":"object","properties":{"items":{"anyOf":[{"nullable":true,"items":{"type":"object","properties":{"id":{"nullable":true,"description":"Creative author and product identity: id.","type":"string"},"video_id":{"nullable":true,"description":"Creative author and product identity: video id.","type":"string"},"uid":{"nullable":true,"description":"Creative author and product identity: uid.","type":"string"},"unique_id":{"nullable":true,"description":"Creative author and product identity: unique id.","type":"string"},"nickname":{"nullable":true,"description":"Creative author and product identity: nickname.","type":"string"},"share_url":{"nullable":true,"description":"Creative author and product identity: share url.","type":"string"},"product_id":{"nullable":true,"description":"Creative author and product identity: product id.","type":"string"},"product_name":{"nullable":true,"description":"Creative author and product identity: product name.","type":"string"},"follower_count":{"nullable":true,"description":"Author follower count: follower count.","type":"integer"},"product_sold_count":{"description":"Provider product sales count."},"ceiling_price":{"description":"Provider upper product price; preserve its currency object and runtime type."},"video_share_count":{"description":"Provider video share count."},"video_30d_gpm":{"description":"Provider 30-day video GPM; preserve its original unit and runtime type."},"video_comment_count":{"description":"Provider video comment count."},"product_rating":{"description":"Provider product rating."},"floor_price":{"description":"Provider lower product price; preserve its currency object and runtime type."},"video_engagement_rate":{"description":"Provider video engagement rate."},"product_l1_category":{"description":"First-level product category."},"product_l2_category":{"description":"Second-level product category."},"commission_rate":{"description":"Provider commission rate."},"product_l3_category":{"description":"Third-level product category."},"product_images":{"description":"Provider product images. The source establishes this field name; preserve its runtime JSON type and missing values."},"video_30d_gmv":{"description":"Provider 30-day video GMV; preserve its original unit and runtime type."},"video_play_count":{"description":"Provider video play count."},"product_status":{"description":"Provider product status."},"video_like_count":{"description":"Provider video like count."},"video_collect_count":{"description":"Provider video collect count."},"product_gmv":{"description":"Provider product GMV; preserve its original unit and runtime type."}},"additionalProperties":true},"type":"array"},{"type":"null"}]},"analysis":{"additionalProperties":true,"properties":{"items":{"anyOf":[{"items":{"type":"object","properties":{"id":{"type":"string","nullable":true,"description":"Creative analysis identifier or classification: id."},"video_id":{"type":"string","nullable":true,"description":"Creative analysis identifier or classification: video id."},"video_uri":{"type":"string","nullable":true,"description":"Creative analysis identifier or classification: video uri."},"country_code":{"type":"string","nullable":true,"description":"Creative analysis identifier or classification: country code."},"platform":{"type":"string","nullable":true,"description":"Creative analysis identifier or classification: platform."},"hook_type":{"type":"string","nullable":true,"description":"Creative analysis identifier or classification: hook type."},"hook_subtype":{"type":"string","nullable":true,"description":"Creative analysis identifier or classification: hook subtype."},"formula_type":{"type":"string","nullable":true,"description":"Creative analysis identifier or classification: formula type."},"formula_subtype":{"type":"string","nullable":true,"description":"Creative analysis identifier or classification: formula subtype."},"angle_type":{"type":"string","nullable":true,"description":"Creative analysis identifier or classification: angle type."},"angle_subtype":{"type":"string","nullable":true,"description":"Creative analysis identifier or classification: angle subtype."},"is_aigc_video":{"type":"boolean","nullable":true,"description":"Provider AIGC flag: is aigc video."},"video_cover":{"description":"Creative video cover media; preserve the provider representation."},"transcription_with_structure":{"description":"Creative transcription with provider structural annotations; preserve its original JSON representation."},"storyboards":{"description":"Creative storyboard and scene analysis; preserve the returned structure."}},"additionalProperties":true},"type":"array"},{"type":"null"}]}},"type":"object","nullable":true},"embedding":{"additionalProperties":true,"properties":{"items":{"anyOf":[{"items":{"type":"object","properties":{"id":{"type":"string","nullable":true,"description":"Creative embedding identity: id."},"video_id":{"type":"string","nullable":true,"description":"Creative embedding identity: video id."},"video_uri":{"type":"string","nullable":true,"description":"Creative embedding identity: video uri."},"country_code":{"type":"string","nullable":true,"description":"Creative embedding identity: country code."},"platform":{"type":"string","nullable":true,"description":"Creative embedding identity: platform."},"embedding":{"type":"array","nullable":true,"description":"Numeric embedding vector; returned only when requested. Avoid inlining the vector in summaries.","items":{"type":"number"}},"matched_tags":{"description":"Tags matched during creative embedding analysis; preserve the provider representation."},"extracted_content":{"description":"Content extracted for creative similarity analysis; preserve the provider representation."},"video_cover":{"description":"Creative video cover media; preserve the provider representation."}},"additionalProperties":true},"type":"array"},{"type":"null"}]}},"type":"object","nullable":true}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-creative-detail","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_creative_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-creative-search/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Creative Search","description":"TikTok Creative Search. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.","operationId":"runChuhaijiangTiktokCreativeSearch","externalDocs":{"description":"Nexscope TikTok Creative Search documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creative-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["country"],"additionalProperties":false,"properties":{"country":{"enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"type":"string","description":"Lowercase request market. Returned country_code may differ; preserve both."},"page":{"minimum":1,"default":1,"type":"integer","description":"Page number, starting at 1. No automatic pagination."},"pageSize":{"minimum":1,"maximum":10,"type":"integer","description":"Items per page, from 1 to 10. Omission preserves the upstream default."},"keyword":{"type":"string","description":"Creative search keyword."},"category":{"type":"string","description":"Provider-approved creative category."},"hasProduct":{"type":"boolean","description":"Whether products are associated."},"isSponsored":{"type":"boolean","description":"Whether content is sponsored."},"isAigc":{"type":"boolean","description":"Whether content is generated by AI."},"sort":{"default":"gmv:desc","pattern":"^[^:]+:(asc|desc)$","type":"string","description":"Provider-approved field followed by :asc or :desc. No complete field enum is published."}},"type":"object"},"example":{"page":1,"pageSize":3,"country":"us"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"data":{"type":"object","properties":{"items":{"anyOf":[{"nullable":true,"items":{"type":"object","properties":{"id":{"nullable":true,"description":"Creative identity and copy: id.","type":"string"},"video_id":{"nullable":true,"description":"Creative identity and copy: video id.","type":"string"},"product_id":{"nullable":true,"description":"Creative identity and copy: product id.","type":"string"},"author_uid":{"nullable":true,"description":"Creative identity and copy: author uid.","type":"string"},"author_unique_id":{"nullable":true,"description":"Creative identity and copy: author unique id.","type":"string"},"author_nickname":{"nullable":true,"description":"Creative identity and copy: author nickname.","type":"string"},"video_desc":{"nullable":true,"description":"Creative identity and copy: video desc.","type":"string"},"country_code":{"nullable":true,"description":"Creative identity and copy: country code.","type":"string"},"platform":{"nullable":true,"description":"Creative identity and copy: platform.","type":"string"},"follower_cnt":{"nullable":true,"description":"Creative audience and engagement count: follower cnt.","type":"integer"},"video_play_count":{"nullable":true,"description":"Creative audience and engagement count: video play count.","type":"integer"},"video_like_count":{"nullable":true,"description":"Creative audience and engagement count: video like count.","type":"integer"},"video_comment_count":{"nullable":true,"description":"Creative audience and engagement count: video comment count.","type":"integer"},"video_share_count":{"nullable":true,"description":"Creative audience and engagement count: video share count.","type":"integer"},"video_collect_count":{"nullable":true,"description":"Creative audience and engagement count: video collect count.","type":"integer"},"video_engagement_rate":{"nullable":true,"description":"Provider engagement ratio: video engagement rate.","type":"number"},"video_30d_gmv":{"nullable":true,"description":"Monetary metric with original unit and value: video 30d gmv.","type":"object"},"video_total_gmv":{"nullable":true,"description":"Monetary metric with original unit and value: video total gmv.","type":"object"},"video_30d_gpm":{"nullable":true,"description":"Monetary metric with original unit and value: video 30d gpm.","type":"object"},"content_intent":{"description":"Provider content intent. The source establishes this field name; preserve its runtime JSON type and missing values."},"user_avatar":{"description":"Provider user avatar. The source establishes this field name; preserve its runtime JSON type and missing values."},"is_aigc_video":{"description":"Provider is aigc video. The source establishes this field name; preserve its runtime JSON type and missing values."},"content_tag_v2":{"description":"Provider content tag v2. The source establishes this field name; preserve its runtime JSON type and missing values."},"video_launch_time":{"description":"Provider video launch time. The source establishes this field name; preserve its runtime JSON type and missing values."},"video_date":{"description":"Provider video date. The source establishes this field name; preserve its runtime JSON type and missing values."},"video_duration":{"description":"Provider video duration. The source establishes this field name; preserve its runtime JSON type and missing values."}},"additionalProperties":true},"type":"array"},{"type":"null"}]},"total_count":{"anyOf":[{"nullable":true,"type":"integer"},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[],"total_count":0}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-creative-search","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_creative_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-ad-related-products/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Ad Related Products","description":"TikTok Ad Related Products. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.","operationId":"runChuhaijiangTiktokAdRelatedProducts","externalDocs":{"description":"Nexscope TikTok Ad Related Products documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-ad-related-products"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["country","id"],"additionalProperties":false,"properties":{"country":{"enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"type":"string","description":"Lowercase request market. Returned country_code may differ; preserve both."},"id":{"minLength":1,"type":"string","description":"Ad ID returned by its search operation. Keep identifiers as strings to avoid precision loss."},"page":{"minimum":1,"default":1,"type":"integer","description":"Page number, starting at 1. No automatic pagination."},"pageSize":{"minimum":1,"maximum":10,"type":"integer","description":"Items per page, from 1 to 10. Omission preserves the upstream default."}},"type":"object"},"example":{"pageSize":3,"page":1,"country":"us","id":"7658119807128046879"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"data":{"type":"object","properties":{"items":{"anyOf":[{"nullable":true,"items":{"type":"object","properties":{"id":{"nullable":true,"description":"Related product identity: id.","type":"string"},"tiktok_product_detail_product_name":{"nullable":true,"description":"Related product identity: tiktok product detail product name.","type":"string"},"tiktok_product_detail_floor_price":{"nullable":true,"description":"Price with original unit and value: tiktok product detail floor price.","type":"object"},"tiktok_product_detail_ceiling_price":{"nullable":true,"description":"Price with original unit and value: tiktok product detail ceiling price.","type":"object"},"tiktok_product_detail_product_rating":{"nullable":true,"description":"Provider product rating: tiktok product detail product rating.","type":"number"},"tiktok_ads_detail_product_id":{"nullable":true,"description":"Ad related product identity: tiktok ads detail product id.","type":"string"},"tiktok_ads_detail_video_id":{"nullable":true,"description":"Ad related product identity: tiktok ads detail video id.","type":"string"},"tiktok_ads_detail_product_country_code":{"nullable":true,"description":"Ad related product identity: tiktok ads detail product country code.","type":"string"},"tiktok_ads_detail_product_total_sold_count":{"nullable":true,"description":"Ad attributed sales count: tiktok ads detail product total sold count.","type":"integer"},"tiktok_ads_detail_video_30d_sold_count":{"nullable":true,"description":"Ad attributed sales count: tiktok ads detail video 30d sold count.","type":"integer"},"tiktok_ads_detail_product_total_gmv":{"nullable":true,"description":"GMV preserving original unit and value: tiktok ads detail product total gmv.","type":"object"},"tiktok_ads_detail_video_30d_gmv":{"nullable":true,"description":"GMV preserving original unit and value: tiktok ads detail video 30d gmv.","type":"object"},"tiktok_ads_detail_product_launch_time":{"description":"Provider tiktok ads detail product launch time. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_product_detail_l3_category":{"description":"Provider tiktok product detail l3 category. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_product_detail_product_images":{"description":"Provider tiktok product detail product images. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_product_detail_product_sku_props":{"description":"Provider tiktok product detail product sku props. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_product_detail_region":{"description":"Provider tiktok product detail region. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_product_detail_product_skus":{"description":"Provider tiktok product detail product skus. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_product_detail_commission_rate":{"description":"Provider tiktok product detail commission rate. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_product_detail_l1_category":{"description":"Provider tiktok product detail l1 category. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_product_detail_product_status":{"description":"Provider tiktok product detail product status. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_product_detail_l2_category":{"description":"Provider tiktok product detail l2 category. The source establishes this field name; preserve its runtime JSON type and missing values."}},"additionalProperties":true},"type":"array"},{"type":"null"}]},"total_count":{"anyOf":[{"nullable":true,"type":"integer"},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[],"total_count":0}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-ad-related-products","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_ad_related_products","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-ad-detail/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Ad Detail","description":"TikTok Ad Detail. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.","operationId":"runChuhaijiangTiktokAdDetail","externalDocs":{"description":"Nexscope TikTok Ad Detail documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-ad-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["country","id"],"additionalProperties":false,"properties":{"country":{"enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"type":"string","description":"Lowercase request market. Returned country_code may differ; preserve both."},"id":{"minLength":1,"type":"string","description":"Ad ID returned by its search operation. Keep identifiers as strings to avoid precision loss."},"include":{"pattern":"^(core)(,(core))*$","type":"string","description":"Comma-separated expansions: core. Request only needed expansions."}},"type":"object"},"example":{"include":"core","country":"us","id":"7658119807128046879"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"data":{"type":"object","properties":{"items":{"anyOf":[{"nullable":true,"items":{"type":"object","properties":{"id":{"nullable":true,"description":"Ad identity and copy: id.","type":"string"},"ad_title":{"nullable":true,"description":"Ad identity and copy: ad title.","type":"string"},"advertiser_id":{"nullable":true,"description":"Ad identity and copy: advertiser id.","type":"string"},"advertiser_name":{"nullable":true,"description":"Ad identity and copy: advertiser name.","type":"string"},"ad_url":{"nullable":true,"description":"Ad identity and copy: ad url.","type":"string"},"web_url":{"nullable":true,"description":"Ad identity and copy: web url.","type":"string"},"button_text":{"nullable":true,"description":"Ad identity and copy: button text.","type":"string"},"advertiser_avatar":{"nullable":true,"description":"Provider image object: advertiser avatar.","type":"object"},"ad_cover":{"nullable":true,"description":"Provider image object: ad cover.","type":"object"},"duration":{"nullable":true,"description":"Provider time or duration; preserve original units: duration.","type":"integer"},"ad_create_time":{"nullable":true,"description":"Provider time or duration; preserve original units: ad create time.","type":"integer"},"create_time":{"nullable":true,"description":"Provider time or duration; preserve original units: create time.","type":"integer"},"last_update_time":{"nullable":true,"description":"Provider time or duration; preserve original units: last update time.","type":"integer"}},"additionalProperties":true},"type":"array"},{"type":"null"}]},"core":{"additionalProperties":true,"properties":{"items":{"anyOf":[{"items":{"type":"object","properties":{"id":{"type":"string","nullable":true,"description":"Core ad identity or provider ad type: id."},"core_creative_id":{"type":"string","nullable":true,"description":"Core ad identity or provider ad type: core creative id."},"core_ad_type":{"type":"string","nullable":true,"description":"Core ad identity or provider ad type: core ad type."},"core_ad_day_count":{"type":"integer","nullable":true,"description":"Core ad performance count: core ad day count."},"core_total_sc":{"type":"integer","nullable":true,"description":"Core ad performance count: core total sc."},"core_video_play_count":{"type":"integer","nullable":true,"description":"Core ad performance count: core video play count."},"core_video_like_count":{"type":"integer","nullable":true,"description":"Core ad performance count: core video like count."},"core_video_comment_count":{"type":"integer","nullable":true,"description":"Core ad performance count: core video comment count."},"core_video_share_count":{"type":"integer","nullable":true,"description":"Core ad performance count: core video share count."},"core_video_collect_count":{"type":"integer","nullable":true,"description":"Core ad performance count: core video collect count."},"core_ad_play_ratio":{"type":"number","nullable":true,"description":"Provider ratio or score; preserve original metric definition: core ad play ratio."},"core_ad_gmv_ratio":{"type":"number","nullable":true,"description":"Provider ratio or score; preserve original metric definition: core ad gmv ratio."},"core_ad_roas":{"type":"number","nullable":true,"description":"Provider ratio or score; preserve original metric definition: core ad roas."},"core_video_popularity":{"type":"number","nullable":true,"description":"Provider ratio or score; preserve original metric definition: core video popularity."},"core_ad_maximum_cost":{"type":"object","nullable":true,"description":"Provider monetary metric; preserve original unit and value: core ad maximum cost."},"core_total_gmv":{"type":"object","nullable":true,"description":"Provider monetary metric; preserve original unit and value: core total gmv."},"core_video_gpm_30d":{"type":"object","nullable":true,"description":"Provider monetary metric; preserve original unit and value: core video gpm 30d."}},"additionalProperties":true},"type":"array"},{"type":"null"}]}},"type":"object","nullable":true}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-ad-detail","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_ad_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-ad-search/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Ad Search","description":"TikTok Ad Search. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.","operationId":"runChuhaijiangTiktokAdSearch","externalDocs":{"description":"Nexscope TikTok Ad Search documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-ad-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["country"],"additionalProperties":false,"properties":{"country":{"enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"type":"string","description":"Lowercase request market. Returned country_code may differ; preserve both."},"page":{"minimum":1,"default":1,"type":"integer","description":"Page number, starting at 1. No automatic pagination."},"pageSize":{"minimum":1,"maximum":10,"type":"integer","description":"Items per page, from 1 to 10. Omission preserves the upstream default."},"keyword":{"type":"string","description":"Ad search keyword."},"category":{"type":"string","description":"Provider-approved product category."},"adType":{"type":"string","description":"Provider-approved ad type value; no enum is published."},"excludeSparkAds":{"type":"boolean","description":"Whether to exclude Spark Ads."},"minViews":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"maxViews":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"minGmv":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"maxGmv":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"minDays":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"maxDays":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"sort":{"default":"gmv:desc","pattern":"^[^:]+:(asc|desc)$","type":"string","description":"Provider-approved field followed by :asc or :desc. No complete field enum is published."}},"type":"object"},"example":{"page":1,"pageSize":3,"country":"us"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"data":{"type":"object","properties":{"items":{"anyOf":[{"nullable":true,"items":{"type":"object","properties":{"id":{"nullable":true,"description":"Ad identity and copy: id.","type":"string"},"video_id":{"nullable":true,"description":"Ad identity and copy: video id.","type":"string"},"product_id":{"nullable":true,"description":"Ad identity and copy: product id.","type":"string"},"advertiser_id":{"nullable":true,"description":"Ad identity and copy: advertiser id.","type":"string"},"ad_url":{"nullable":true,"description":"Ad identity and copy: ad url.","type":"string"},"web_url":{"nullable":true,"description":"Ad identity and copy: web url.","type":"string"},"advertiser_url":{"nullable":true,"description":"Ad identity and copy: advertiser url.","type":"string"},"ad_title":{"nullable":true,"description":"Ad identity and copy: ad title.","type":"string"},"advertiser_name":{"nullable":true,"description":"Ad identity and copy: advertiser name.","type":"string"},"button_text":{"nullable":true,"description":"Ad identity and copy: button text.","type":"string"},"product_title":{"nullable":true,"description":"Ad identity and copy: product title.","type":"string"},"video_play_count":{"nullable":true,"description":"Ad delivery count: video play count.","type":"integer"},"video_like_count":{"nullable":true,"description":"Ad delivery count: video like count.","type":"integer"},"ad_day_count":{"nullable":true,"description":"Ad delivery count: ad day count.","type":"integer"},"video_like_rate":{"nullable":true,"description":"Provider engagement ratio: video like rate.","type":"number"},"video_engagement_rate":{"nullable":true,"description":"Provider engagement ratio: video engagement rate.","type":"number"},"total_gmv":{"nullable":true,"description":"Monetary metric with original unit and value: total gmv.","type":"object"},"video_gpm_30d":{"nullable":true,"description":"Monetary metric with original unit and value: video gpm 30d.","type":"object"},"ad_create_time":{"description":"Provider ad create time. The source establishes this field name; preserve its runtime JSON type and missing values."},"total_sc":{"description":"Provider total sc. The source establishes this field name; preserve its runtime JSON type and missing values."},"last_update_time":{"description":"Provider last update time. The source establishes this field name; preserve its runtime JSON type and missing values."},"video_popularity":{"description":"Provider video popularity. The source establishes this field name; preserve its runtime JSON type and missing values."},"ad_roas":{"description":"Provider return on ad spend; preserve the runtime JSON type and metric definition."},"duration":{"description":"Provider duration. The source establishes this field name; preserve its runtime JSON type and missing values."},"create_time":{"description":"Provider create time. The source establishes this field name; preserve its runtime JSON type and missing values."},"product_l1_category":{"description":"Provider product l1 category. The source establishes this field name; preserve its runtime JSON type and missing values."},"product_l2_category":{"description":"Provider product l2 category. The source establishes this field name; preserve its runtime JSON type and missing values."},"product_l3_category":{"description":"Provider product l3 category. The source establishes this field name; preserve its runtime JSON type and missing values."},"ad_maximum_cost":{"description":"Maximum ad spend as returned; preserve monetary units and the runtime JSON type."}},"additionalProperties":true},"type":"array"},{"type":"null"}]},"total_count":{"anyOf":[{"nullable":true,"type":"integer"},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[],"total_count":0}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-ad-search","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_ad_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-video-reviews/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Video Reviews","description":"TikTok Video Reviews. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.","operationId":"runChuhaijiangTiktokVideoReviews","externalDocs":{"description":"Nexscope TikTok Video Reviews documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-video-reviews"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["country","id"],"additionalProperties":false,"properties":{"country":{"enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"type":"string","description":"Lowercase request market. Returned country_code may differ; preserve both."},"id":{"minLength":1,"type":"string","description":"Video ID returned by its search operation. Keep identifiers as strings to avoid precision loss."},"page":{"minimum":1,"default":1,"type":"integer","description":"Page number, starting at 1. No automatic pagination."},"pageSize":{"minimum":1,"maximum":10,"type":"integer","description":"Items per page, from 1 to 10. Omission preserves the upstream default."}},"type":"object"},"example":{"pageSize":3,"page":1,"country":"us","id":"6788833646091504902"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"data":{"type":"object","properties":{"items":{"anyOf":[{"nullable":true,"items":{"type":"object","properties":{"tiktok_video_detail_comment_id":{"nullable":true,"description":"Comment identity and text: tiktok video detail comment id.","type":"string"},"tiktok_video_detail_comment_text":{"nullable":true,"description":"Comment identity and text: tiktok video detail comment text.","type":"string"},"tiktok_video_detail_comment_unique_id":{"nullable":true,"description":"Comment identity and text: tiktok video detail comment unique id.","type":"string"},"tiktok_video_detail_comment_nickname":{"nullable":true,"description":"Comment identity and text: tiktok video detail comment nickname.","type":"string"},"tiktok_video_detail_video_id":{"nullable":true,"description":"Comment identity and text: tiktok video detail video id.","type":"string"},"tiktok_video_detail_comment_create_time":{"nullable":true,"description":"Provider comment timestamp or count; preserve original units: tiktok video detail comment create time.","type":"integer"},"tiktok_video_detail_comment_like_count":{"nullable":true,"description":"Provider comment timestamp or count; preserve original units: tiktok video detail comment like count.","type":"integer"},"tiktok_video_detail_comment_reply_count":{"nullable":true,"description":"Provider comment timestamp or count; preserve original units: tiktok video detail comment reply count.","type":"integer"},"tiktok_video_detail_comment_user_avatar":{"nullable":true,"description":"Avatar object with thumb_url and url: tiktok video detail comment user avatar.","type":"object"}},"additionalProperties":true},"type":"array"},{"type":"null"}]},"total_count":{"anyOf":[{"nullable":true,"type":"integer"},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[],"total_count":0}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-video-reviews","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_video_reviews","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-video-related-products/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Video Related Products","description":"TikTok Video Related Products. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.","operationId":"runChuhaijiangTiktokVideoRelatedProducts","externalDocs":{"description":"Nexscope TikTok Video Related Products documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-video-related-products"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["country","id"],"additionalProperties":false,"properties":{"country":{"enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"type":"string","description":"Lowercase request market. Returned country_code may differ; preserve both."},"id":{"minLength":1,"type":"string","description":"Video ID returned by its search operation. Keep identifiers as strings to avoid precision loss."},"page":{"minimum":1,"default":1,"type":"integer","description":"Page number, starting at 1. No automatic pagination."},"pageSize":{"minimum":1,"maximum":10,"type":"integer","description":"Items per page, from 1 to 10. Omission preserves the upstream default."}},"type":"object"},"example":{"pageSize":3,"page":1,"country":"us","id":"7672655263672864013"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"data":{"type":"object","properties":{"items":{"anyOf":[{"nullable":true,"items":{"type":"object","properties":{"id":{"nullable":true,"description":"Related product identity: id.","type":"string"},"tiktok_product_detail_product_name":{"nullable":true,"description":"Related product identity: tiktok product detail product name.","type":"string"},"tiktok_product_detail_floor_price":{"nullable":true,"description":"Price with original unit and value: tiktok product detail floor price.","type":"object"},"tiktok_product_detail_ceiling_price":{"nullable":true,"description":"Price with original unit and value: tiktok product detail ceiling price.","type":"object"},"tiktok_product_detail_product_rating":{"nullable":true,"description":"Provider product rating: tiktok product detail product rating.","type":"number"},"tiktok_video_detail_product_id":{"nullable":true,"description":"Product and video identifier: tiktok video detail product id.","type":"string"},"tiktok_video_detail_video_id":{"nullable":true,"description":"Product and video identifier: tiktok video detail video id.","type":"string"},"tiktok_video_detail_product_total_sold_count":{"nullable":true,"description":"Video attributed sales count: tiktok video detail product total sold count.","type":"integer"},"tiktok_video_detail_video_30d_sold_count":{"nullable":true,"description":"Video attributed sales count: tiktok video detail video 30d sold count.","type":"integer"},"tiktok_video_detail_product_total_gmv":{"nullable":true,"description":"GMV with original unit and value: tiktok video detail product total gmv.","type":"object"},"tiktok_video_detail_video_30d_gmv":{"nullable":true,"description":"GMV with original unit and value: tiktok video detail video 30d gmv.","type":"object"},"tiktok_product_detail_product_sku_props":{"description":"Provider tiktok product detail product sku props. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_product_detail_product_images":{"description":"Provider tiktok product detail product images. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_product_detail_l1_category":{"description":"Provider tiktok product detail l1 category. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_product_detail_product_skus":{"description":"Provider tiktok product detail product skus. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_product_detail_l2_category":{"description":"Provider tiktok product detail l2 category. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_product_detail_l3_category":{"description":"Provider tiktok product detail l3 category. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_product_detail_product_status":{"description":"Provider tiktok product detail product status. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_product_detail_commission_rate":{"description":"Provider tiktok product detail commission rate. The source establishes this field name; preserve its runtime JSON type and missing values."}},"additionalProperties":true},"type":"array"},{"type":"null"}]},"total_count":{"anyOf":[{"nullable":true,"type":"integer"},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[],"total_count":0}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-video-related-products","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_video_related_products","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-video-detail/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Video Detail","description":"TikTok Video Detail. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.","operationId":"runChuhaijiangTiktokVideoDetail","externalDocs":{"description":"Nexscope TikTok Video Detail documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-video-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["country","id"],"additionalProperties":false,"properties":{"country":{"enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"type":"string","description":"Lowercase request market. Returned country_code may differ; preserve both."},"id":{"minLength":1,"type":"string","description":"Video ID returned by its search operation. Keep identifiers as strings to avoid precision loss."},"include":{"pattern":"^(core)(,(core))*$","type":"string","description":"Comma-separated expansions: core. Request only needed expansions."}},"type":"object"},"example":{"include":"core","country":"us","id":"6788833646091504902"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"data":{"type":"object","properties":{"items":{"anyOf":[{"nullable":true,"items":{"type":"object","properties":{"id":{"nullable":true,"description":"Video detail identity: id.","type":"string"},"unique_id":{"nullable":true,"description":"Video detail identity: unique id.","type":"string"},"nickname":{"nullable":true,"description":"Video detail identity: nickname.","type":"string"},"share_url":{"nullable":true,"description":"Video detail identity: share url.","type":"string"},"video_cover":{"nullable":true,"description":"Provider image object: video cover.","type":"object"},"user_avatar":{"nullable":true,"description":"Provider image object: user avatar.","type":"object"},"video_duration":{"nullable":true,"description":"Provider duration or author count; preserve original units: video duration.","type":"integer"},"follower_count":{"nullable":true,"description":"Provider duration or author count; preserve original units: follower count.","type":"integer"},"video_count":{"nullable":true,"description":"Provider duration or author count; preserve original units: video count.","type":"integer"},"video_avg_play_count":{"nullable":true,"description":"Author historical average metric: video avg play count.","type":"number"},"video_avg_like_count":{"nullable":true,"description":"Author historical average metric: video avg like count.","type":"number"},"author_avg_engagement_rate":{"nullable":true,"description":"Author historical average metric: author avg engagement rate.","type":"number"},"had_product":{"nullable":true,"description":"Provider content flag: had product.","type":"boolean"},"has_comment":{"nullable":true,"description":"Provider content flag: has comment.","type":"boolean"}},"additionalProperties":true},"type":"array"},{"type":"null"}]},"core":{"additionalProperties":true,"properties":{"items":{"anyOf":[{"items":{"type":"object","properties":{"core_country_code":{"type":"string","nullable":true,"description":"Country of the returned video: core country code."},"core_video_play_count":{"type":"integer","nullable":true,"description":"Core video engagement count: core video play count."},"core_video_like_count":{"type":"integer","nullable":true,"description":"Core video engagement count: core video like count."},"core_video_comment_count":{"type":"integer","nullable":true,"description":"Core video engagement count: core video comment count."},"core_video_share_count":{"type":"integer","nullable":true,"description":"Core video engagement count: core video share count."},"core_video_collect_count":{"type":"integer","nullable":true,"description":"Core video engagement count: core video collect count."},"core_video_engagement_rate":{"type":"number","nullable":true,"description":"Core video decimal ratio: core video engagement rate."},"core_video_like_play_ratio":{"type":"number","nullable":true,"description":"Core video decimal ratio: core video like play ratio."},"core_video_30d_gpm":{"type":"object","nullable":true,"description":"Thirty-day GPM with original unit and value: core video 30d gpm."}},"additionalProperties":true},"type":"array"},{"type":"null"}]}},"type":"object","nullable":true}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-video-detail","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_video_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-video-search/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Video Keyword Search","description":"TikTok Video Keyword Search. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.","operationId":"runChuhaijiangTiktokVideoSearch","externalDocs":{"description":"Nexscope TikTok Video Search documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-video-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["country"],"additionalProperties":false,"properties":{"country":{"enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"type":"string","description":"Lowercase request market. Returned country_code may differ; preserve both."},"page":{"minimum":1,"default":1,"type":"integer","description":"Page number, starting at 1. No automatic pagination."},"pageSize":{"minimum":1,"maximum":10,"type":"integer","description":"Items per page, from 1 to 10. Omission preserves the upstream default."},"keyword":{"type":"string","description":"Video copy or related keyword."},"category":{"type":"string","description":"Use only provider-approved categories; no category enum is published."},"isCommercial":{"type":"boolean","description":"Filter videos promoting products."},"minViews":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"maxViews":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"minLikes":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"maxLikes":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"minGmv30d":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"maxGmv30d":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"minEngagement":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"maxEngagement":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"accountType":{"enum":[0,3,4],"type":"integer","description":"Provider account type; business labels are unpublished."},"sort":{"default":"views:desc","pattern":"^[^:]+:(asc|desc)$","type":"string","description":"Provider-approved field followed by :asc or :desc. No complete field enum is published."}},"type":"object"},"example":{"page":1,"pageSize":3,"country":"us"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"data":{"type":"object","properties":{"items":{"anyOf":[{"nullable":true,"items":{"type":"object","properties":{"id":{"nullable":true,"description":"Video identity: id.","type":"string"},"video_desc":{"nullable":true,"description":"Video identity: video desc.","type":"string"},"share_url":{"nullable":true,"description":"Video identity: share url.","type":"string"},"author_id":{"nullable":true,"description":"Video identity: author id.","type":"string"},"author_unique_id":{"nullable":true,"description":"Video identity: author unique id.","type":"string"},"author_nickname":{"nullable":true,"description":"Video identity: author nickname.","type":"string"},"country_code":{"nullable":true,"description":"Video identity: country code.","type":"string"},"video_play_count":{"nullable":true,"description":"Engagement count: video play count.","type":"integer"},"video_like_count":{"nullable":true,"description":"Engagement count: video like count.","type":"integer"},"video_comment_count":{"nullable":true,"description":"Engagement count: video comment count.","type":"integer"},"video_share_count":{"nullable":true,"description":"Engagement count: video share count.","type":"integer"},"video_collect_count":{"nullable":true,"description":"Engagement count: video collect count.","type":"integer"},"video_engagement_rate":{"nullable":true,"description":"Decimal engagement ratio: video engagement rate.","type":"number"},"video_launch_time":{"nullable":true,"description":"Provider video metadata: video launch time.","type":"integer"},"video_duration":{"nullable":true,"description":"Provider video metadata: video duration.","type":"integer"},"account_type":{"nullable":true,"description":"Provider video metadata: account type.","type":"integer"},"video_30d_gpm":{"nullable":true,"description":"Thirty-day GPM with original unit and value: video 30d gpm.","type":"object"},"is_ad":{"nullable":true,"description":"Optional provider flag: is ad.","type":"boolean"},"is_aigc_video":{"nullable":true,"description":"Optional provider flag: is aigc video.","type":"boolean"},"video_total_like_count_to_follower_count_ratio":{"description":"Provider video total like count to follower count ratio. The source establishes this field name; preserve its runtime JSON type and missing values."}},"additionalProperties":true},"type":"array"},{"type":"null"}]},"total_count":{"anyOf":[{"nullable":true,"type":"integer"},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[],"total_count":0}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-video-search","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_video_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-live-related-products/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Live Related Products","description":"TikTok Live Related Products. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.","operationId":"runChuhaijiangTiktokLiveRelatedProducts","externalDocs":{"description":"Nexscope TikTok Live Related Products documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-live-related-products"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["country","id"],"additionalProperties":false,"properties":{"country":{"enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"type":"string","description":"Lowercase request market. Returned country_code may differ; preserve both."},"id":{"minLength":1,"type":"string","description":"Livestream ID returned by its search operation. Keep identifiers as strings to avoid precision loss."},"page":{"minimum":1,"default":1,"type":"integer","description":"Page number, starting at 1. No automatic pagination."},"pageSize":{"minimum":1,"maximum":10,"type":"integer","description":"Items per page, from 1 to 10. Omission preserves the upstream default."}},"type":"object"},"example":{"pageSize":3,"page":1,"country":"us","id":"7643101948819835678"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"data":{"type":"object","properties":{"items":{"anyOf":[{"nullable":true,"items":{"type":"object","properties":{"id":{"nullable":true,"description":"Livestream product identity: id.","type":"string"},"tiktok_live_detail_product_id":{"nullable":true,"description":"Livestream product identity: tiktok live detail product id.","type":"string"},"tiktok_live_detail_product_title":{"nullable":true,"description":"Livestream product identity: tiktok live detail product title.","type":"string"},"tiktok_live_detail_product_country_code":{"nullable":true,"description":"Livestream product identity: tiktok live detail product country code.","type":"string"},"tiktok_live_detail_product_seller_id":{"nullable":true,"description":"Livestream product identity: tiktok live detail product seller id.","type":"string"},"tiktok_live_detail_product_seller_name":{"nullable":true,"description":"Livestream product identity: tiktok live detail product seller name.","type":"string"},"tiktok_live_detail_product_floor_price":{"nullable":true,"description":"Monetary metric with original unit and value: tiktok live detail product floor price.","type":"object"},"tiktok_live_detail_product_ceiling_price":{"nullable":true,"description":"Monetary metric with original unit and value: tiktok live detail product ceiling price.","type":"object"},"tiktok_live_detail_product_gmv":{"nullable":true,"description":"Monetary metric with original unit and value: tiktok live detail product gmv.","type":"object"},"tiktok_live_detail_product_images":{"nullable":true,"description":"Image with url and thumb_url: tiktok live detail product images.","type":"object"},"tiktok_live_detail_product_seller_avatar":{"nullable":true,"description":"Image with url and thumb_url: tiktok live detail product seller avatar.","type":"object"},"tiktok_live_detail_product_sold_count":{"nullable":true,"description":"Livestream attributed sold units: tiktok live detail product sold count.","type":"integer"},"tiktok_live_detail_product_commission_rate_num":{"nullable":true,"description":"Decimal ratio, which may be absent: tiktok live detail product commission rate num.","type":"number"},"tiktok_live_detail_product_conversion_rate":{"nullable":true,"description":"Decimal ratio, which may be absent: tiktok live detail product conversion rate.","type":"number"},"tiktok_live_detail_product_l3_category":{"description":"Provider tiktok live detail product l3 category. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_live_detail_product_l1_category":{"description":"Provider tiktok live detail product l1 category. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_live_detail_product_seller_category_name_label":{"description":"Provider tiktok live detail product seller category name label. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_live_detail_product_l2_category":{"description":"Provider tiktok live detail product l2 category. The source establishes this field name; preserve its runtime JSON type and missing values."},"tiktok_live_detail_product_seller_info":{"description":"Provider tiktok live detail product seller info. The source establishes this field name; preserve its runtime JSON type and missing values."}},"additionalProperties":true},"type":"array"},{"type":"null"}]},"total_count":{"anyOf":[{"nullable":true,"type":"integer"},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[],"total_count":0}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-live-related-products","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_live_related_products","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-live-detail/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Live Detail","description":"TikTok Live Detail. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.","operationId":"runChuhaijiangTiktokLiveDetail","externalDocs":{"description":"Nexscope TikTok Live Detail documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-live-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["country","id"],"additionalProperties":false,"properties":{"country":{"enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"type":"string","description":"Lowercase request market. Returned country_code may differ; preserve both."},"id":{"minLength":1,"type":"string","description":"Livestream ID returned by its search operation. Keep identifiers as strings to avoid precision loss."},"include":{"pattern":"^(core)(,(core))*$","type":"string","description":"Comma-separated expansions: core. Request only needed expansions."}},"type":"object"},"example":{"include":"core","country":"us","id":"7643101948819835678"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"data":{"type":"object","properties":{"items":{"anyOf":[{"nullable":true,"items":{"type":"object","properties":{"id":{"nullable":true,"description":"Livestream identity: id.","type":"string"},"title":{"nullable":true,"description":"Livestream identity: title.","type":"string"},"room_link":{"nullable":true,"description":"Livestream identity: room link.","type":"string"},"user_id":{"nullable":true,"description":"Livestream identity: user id.","type":"string"},"user_nickname":{"nullable":true,"description":"Livestream identity: user nickname.","type":"string"},"country_code":{"nullable":true,"description":"Livestream identity: country code.","type":"string"},"most_product_category_label":{"nullable":true,"description":"Livestream identity: most product category label.","type":"string"},"start_time":{"nullable":true,"description":"Unix timestamp in milliseconds: start time.","type":"integer"},"end_time":{"nullable":true,"description":"Unix timestamp in milliseconds: end time.","type":"integer"},"cover":{"nullable":true,"description":"Image object with url and thumb_url: cover.","type":"object"},"user_avatar":{"nullable":true,"description":"Host avatar with url and thumb_url: user avatar.","type":"object"},"user_follower_count":{"nullable":true,"description":"Host historical count: user follower count.","type":"integer"},"user_live_count":{"nullable":true,"description":"Host historical count: user live count.","type":"integer"},"user_avg_audience_count":{"nullable":true,"description":"Host historical average audience: user avg audience count.","type":"number"},"user_avg_max_audience_count":{"nullable":true,"description":"Host historical average audience: user avg max audience count.","type":"number"}},"additionalProperties":true},"type":"array"},{"type":"null"}]},"core":{"additionalProperties":true,"properties":{"items":{"anyOf":[{"items":{"type":"object","properties":{"id":{"type":"string","nullable":true,"description":"Core livestream identifier: id."},"core_room_id":{"type":"string","nullable":true,"description":"Core livestream identifier: core room id."},"core_country_code":{"type":"string","nullable":true,"description":"Core livestream identifier: core country code."},"core_gmv":{"type":"object","nullable":true,"description":"Monetary metric with original unit and value: core gmv."},"core_gpm":{"type":"object","nullable":true,"description":"Monetary metric with original unit and value: core gpm."},"core_avg_price":{"type":"object","nullable":true,"description":"Monetary metric with original unit and value: core avg price."},"core_product_count":{"type":"integer","nullable":true,"description":"Core livestream performance count: core product count."},"core_sold_product_id_count":{"type":"integer","nullable":true,"description":"Core livestream performance count: core sold product id count."},"core_total_sold_count":{"type":"integer","nullable":true,"description":"Core livestream performance count: core total sold count."},"core_total_user":{"type":"integer","nullable":true,"description":"Core livestream performance count: core total user."},"core_max_user_count":{"type":"integer","nullable":true,"description":"Core livestream performance count: core max user count."},"core_new_follow_count":{"type":"integer","nullable":true,"description":"Core livestream performance count: core new follow count."},"core_avg_online_viewer":{"type":"number","nullable":true,"description":"Average online audience: core avg online viewer."},"core_follower_conversion_rate":{"type":"number","nullable":true,"description":"Decimal follower conversion ratio: core follower conversion rate."}},"additionalProperties":true},"type":"array"},{"type":"null"}]}},"type":"object","nullable":true}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-live-detail","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_live_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-live-search/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Live Search","description":"TikTok Live Search. Execute only this operation; no automatic retries or pagination. Preserve provider fields and metric units.","operationId":"runChuhaijiangTiktokLiveSearch","externalDocs":{"description":"Nexscope TikTok Live Search documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-live-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["country"],"additionalProperties":false,"properties":{"country":{"enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"type":"string","description":"Lowercase request market. Returned country_code may differ; preserve both."},"page":{"minimum":1,"default":1,"type":"integer","description":"Page number, starting at 1. No automatic pagination."},"pageSize":{"minimum":1,"maximum":10,"type":"integer","description":"Items per page, from 1 to 10. Omission preserves the upstream default."},"keyword":{"type":"string","description":"Livestream keyword."},"category":{"type":"string","description":"Provider-approved livestream category; no enum is published."},"productCategory":{"type":"string","description":"Provider-approved product category."},"isLiving":{"type":"boolean","description":"Filter currently live rooms."},"isCommercial":{"type":"boolean","description":"Filter rooms promoting products."},"minSold":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"maxSold":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"minGmv":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"maxGmv":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"minAudience":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"maxAudience":{"type":"number","description":"Provider filter value; retain the provider metric definition without unit conversion."},"sort":{"default":"gmv:desc","pattern":"^[^:]+:(asc|desc)$","type":"string","description":"Provider-approved field followed by :asc or :desc. No complete field enum is published."}},"type":"object"},"example":{"page":1,"pageSize":3,"country":"us"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"data":{"type":"object","properties":{"items":{"anyOf":[{"nullable":true,"items":{"type":"object","properties":{"id":{"nullable":true,"description":"Livestream identity: id.","type":"string"},"title":{"nullable":true,"description":"Livestream identity: title.","type":"string"},"room_link":{"nullable":true,"description":"Livestream identity: room link.","type":"string"},"user_id":{"nullable":true,"description":"Livestream identity: user id.","type":"string"},"user_nickname":{"nullable":true,"description":"Livestream identity: user nickname.","type":"string"},"country_code":{"nullable":true,"description":"Livestream identity: country code.","type":"string"},"most_product_category_label":{"nullable":true,"description":"Livestream identity: most product category label.","type":"string"},"start_time":{"nullable":true,"description":"Unix timestamp in milliseconds: start time.","type":"integer"},"end_time":{"nullable":true,"description":"Unix timestamp in milliseconds: end time.","type":"integer"},"cover":{"nullable":true,"description":"Image object with url and thumb_url: cover.","type":"object"},"user_unique_id":{"nullable":true,"description":"Host identity: user unique id.","type":"string"},"user_category_label":{"nullable":true,"description":"Host identity: user category label.","type":"string"},"product_count":{"nullable":true,"description":"Livestream performance count: product count.","type":"integer"},"total_sold_count":{"nullable":true,"description":"Livestream performance count: total sold count.","type":"integer"},"total_user":{"nullable":true,"description":"Livestream performance count: total user.","type":"integer"},"max_user_count":{"nullable":true,"description":"Livestream performance count: max user count.","type":"integer"},"new_follow_count":{"nullable":true,"description":"Livestream performance count: new follow count.","type":"integer"},"gmv":{"nullable":true,"description":"Monetary metric preserving original unit and value: gmv.","type":"object"},"gpm":{"nullable":true,"description":"Monetary metric preserving original unit and value: gpm.","type":"object"},"opm":{"nullable":true,"description":"Orders per thousand viewers: opm.","type":"number"}},"additionalProperties":true},"type":"array"},{"type":"null"}]},"total_count":{"anyOf":[{"nullable":true,"type":"integer"},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[],"total_count":0}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-live-search","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_live_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-rankings-growth/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Creator Growth","description":"Provider business records for TikTok Creator Growth. Known row fields: bio_email, category_label, channel_id, creator_oecuid, follower_count, handle, id, interval_new_follower, nickname, tioktok_creator_growth_interval_new_follower_ratio, uid, unique_id, user_avatar, user_sell_product_l1_category, video_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokCreatorRankingsGrowth","externalDocs":{"description":"Nexscope TikTok Creator Growth documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creator-rankings-growth"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":20,"example":5},"date":{"type":"string","description":"Ranking date in YYYYMMDD format.","pattern":"^[0-9]{8}$","example":"20260824"},"granularity":{"type":"string","description":"Ranking period.","enum":["daily","weekly","monthly","0","1","2"],"example":"daily"},"sort":{"type":"string","description":"Provider sort field and direction (field:asc or field:desc).","default":"new_follower_count:desc","pattern":"^[A-Za-z0-9_]+:(asc|desc)$","example":"new_follower_count:desc"},"creatorCategory":{"type":"string","description":"Creator category."},"productCategory":{"type":"string","description":"Product category."}},"required":["country","date","granularity"]},"example":{"country":"us","pageSize":10,"date":"20260828","granularity":"daily"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"bio_email":{"description":"Source-documented bio_email; may be absent or null. Preserve the provider value and original monetary units."},"category_label":{"description":"Source-documented category_label; may be absent or null. Preserve the provider value and original monetary units."},"channel_id":{"description":"Source-documented channel_id; may be absent or null. Preserve the provider value and original monetary units."},"creator_oecuid":{"description":"Source-documented creator_oecuid; may be absent or null. Preserve the provider value and original monetary units."},"follower_count":{"description":"Source-documented follower_count; may be absent or null. Preserve the provider value and original monetary units."},"handle":{"description":"Source-documented handle; may be absent or null. Preserve the provider value and original monetary units."},"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"interval_new_follower":{"description":"Source-documented interval_new_follower; may be absent or null. Preserve the provider value and original monetary units."},"nickname":{"description":"Source-documented nickname; may be absent or null. Preserve the provider value and original monetary units."},"tioktok_creator_growth_interval_new_follower_ratio":{"description":"Source-documented tioktok_creator_growth_interval_new_follower_ratio; may be absent or null. Preserve the provider value and original monetary units."},"uid":{"description":"Source-documented uid; may be absent or null. Preserve the provider value and original monetary units."},"unique_id":{"description":"Source-documented unique_id; may be absent or null. Preserve the provider value and original monetary units."},"user_avatar":{"description":"Source-documented user_avatar; may be absent or null. Preserve the provider value and original monetary units."},"user_sell_product_l1_category":{"description":"Source-documented user_sell_product_l1_category; may be absent or null. Preserve the provider value and original monetary units."},"video_count":{"description":"Source-documented video_count; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Creator Growth. Known row fields: bio_email, category_label, channel_id, creator_oecuid, follower_count, handle, id, interval_new_follower, nickname, tioktok_creator_growth_interval_new_follower_ratio, uid, unique_id, user_avatar, user_sell_product_l1_category, video_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"bio_email":null,"category_label":null,"channel_id":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-creator-rankings-growth","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_creator_rankings_growth","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-rankings-commercial/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Creator Commercial","description":"Provider business records for TikTok Creator Commercial. Known row fields: bio_email, category_label, country_code, creator_oecuid, follower_count, handle, id, interval_ecom_video_play_count_growth, interval_live_user, interval_new_follower, l1_category_aggregated_live_gmv, l1_category_aggregated_total_gmv, l1_category_aggregated_video_gmv, nickname, product_count, titkok_creator_commercial_interval_live_gmv, titkok_creator_commercial_interval_total_video_live_gmv, titkok_creator_commercial_interval_video_gmv, uid, unique_id, user_avatar, user_sell_product_l1_category. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokCreatorRankingsCommercial","externalDocs":{"description":"Nexscope TikTok Creator Commercial documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creator-rankings-commercial"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":20,"example":5},"date":{"type":"string","description":"Ranking date in YYYYMMDD format.","pattern":"^[0-9]{8}$","example":"20260824"},"granularity":{"type":"string","description":"Ranking period.","enum":["daily","weekly","monthly","0","1","2"],"example":"daily"},"sort":{"type":"string","description":"Provider sort field and direction (field:asc or field:desc).","default":"total_gmv:desc","pattern":"^[A-Za-z0-9_]+:(asc|desc)$","example":"total_gmv:desc"},"creatorCategory":{"type":"string","description":"Creator category."},"productCategory":{"type":"string","description":"Product category."}},"required":["country","date","granularity"]},"example":{"country":"us","pageSize":10,"date":"20260828","granularity":"daily"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"bio_email":{"description":"Source-documented bio_email; may be absent or null. Preserve the provider value and original monetary units."},"category_label":{"description":"Source-documented category_label; may be absent or null. Preserve the provider value and original monetary units."},"country_code":{"description":"Source-documented country_code; may be absent or null. Preserve the provider value and original monetary units."},"creator_oecuid":{"description":"Source-documented creator_oecuid; may be absent or null. Preserve the provider value and original monetary units."},"follower_count":{"description":"Source-documented follower_count; may be absent or null. Preserve the provider value and original monetary units."},"handle":{"description":"Source-documented handle; may be absent or null. Preserve the provider value and original monetary units."},"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"interval_ecom_video_play_count_growth":{"description":"Source-documented interval_ecom_video_play_count_growth; may be absent or null. Preserve the provider value and original monetary units."},"interval_live_user":{"description":"Source-documented interval_live_user; may be absent or null. Preserve the provider value and original monetary units."},"interval_new_follower":{"description":"Source-documented interval_new_follower; may be absent or null. Preserve the provider value and original monetary units."},"l1_category_aggregated_live_gmv":{"description":"Source-documented l1_category_aggregated_live_gmv; may be absent or null. Preserve the provider value and original monetary units."},"l1_category_aggregated_total_gmv":{"description":"Source-documented l1_category_aggregated_total_gmv; may be absent or null. Preserve the provider value and original monetary units."},"l1_category_aggregated_video_gmv":{"description":"Source-documented l1_category_aggregated_video_gmv; may be absent or null. Preserve the provider value and original monetary units."},"nickname":{"description":"Source-documented nickname; may be absent or null. Preserve the provider value and original monetary units."},"product_count":{"description":"Source-documented product_count; may be absent or null. Preserve the provider value and original monetary units."},"titkok_creator_commercial_interval_live_gmv":{"description":"Source-documented titkok_creator_commercial_interval_live_gmv; may be absent or null. Preserve the provider value and original monetary units."},"titkok_creator_commercial_interval_total_video_live_gmv":{"description":"Source-documented titkok_creator_commercial_interval_total_video_live_gmv; may be absent or null. Preserve the provider value and original monetary units."},"titkok_creator_commercial_interval_video_gmv":{"description":"Source-documented titkok_creator_commercial_interval_video_gmv; may be absent or null. Preserve the provider value and original monetary units."},"uid":{"description":"Source-documented uid; may be absent or null. Preserve the provider value and original monetary units."},"unique_id":{"description":"Source-documented unique_id; may be absent or null. Preserve the provider value and original monetary units."},"user_avatar":{"description":"Source-documented user_avatar; may be absent or null. Preserve the provider value and original monetary units."},"user_sell_product_l1_category":{"description":"Source-documented user_sell_product_l1_category; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Creator Commercial. Known row fields: bio_email, category_label, country_code, creator_oecuid, follower_count, handle, id, interval_ecom_video_play_count_growth, interval_live_user, interval_new_follower, l1_category_aggregated_live_gmv, l1_category_aggregated_total_gmv, l1_category_aggregated_video_gmv, nickname, product_count, titkok_creator_commercial_interval_live_gmv, titkok_creator_commercial_interval_total_video_live_gmv, titkok_creator_commercial_interval_video_gmv, uid, unique_id, user_avatar, user_sell_product_l1_category. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"bio_email":null,"category_label":null,"country_code":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-creator-rankings-commercial","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_creator_rankings_commercial","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-rankings-agencies/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Creator Agencies","description":"Provider business records for TikTok Creator Agencies. Known row fields: avg_commission_rate, follower_count, has_email_address, has_phone, has_whats_app, id, partner_icon, partner_id, partner_name, partner_top3_category, partner_top3_category_list, total_30d_video_live_gmv, total_30d_video_live_sold_count, total_related_creator_count, total_related_product_count, total_related_seller_count, video_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokCreatorRankingsAgencies","externalDocs":{"description":"Nexscope TikTok Creator Agencies documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creator-rankings-agencies"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":20,"example":5},"sort":{"type":"string","description":"Provider sort field and direction (field:asc or field:desc).","default":"gmv_30d:desc","pattern":"^[A-Za-z0-9_]+:(asc|desc)$","example":"gmv_30d:desc"},"category":{"type":"string","description":"Agency category."}},"required":["country"]},"example":{"country":"us","pageSize":10}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"avg_commission_rate":{"description":"Source-documented avg_commission_rate; may be absent or null. Preserve the provider value and original monetary units."},"follower_count":{"description":"Source-documented follower_count; may be absent or null. Preserve the provider value and original monetary units."},"has_email_address":{"description":"Source-documented has_email_address; may be absent or null. Preserve the provider value and original monetary units."},"has_phone":{"description":"Source-documented has_phone; may be absent or null. Preserve the provider value and original monetary units."},"has_whats_app":{"description":"Source-documented has_whats_app; may be absent or null. Preserve the provider value and original monetary units."},"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"partner_icon":{"description":"Source-documented partner_icon; may be absent or null. Preserve the provider value and original monetary units."},"partner_id":{"description":"Source-documented partner_id; may be absent or null. Preserve the provider value and original monetary units."},"partner_name":{"description":"Source-documented partner_name; may be absent or null. Preserve the provider value and original monetary units."},"partner_top3_category":{"description":"Source-documented partner_top3_category; may be absent or null. Preserve the provider value and original monetary units."},"partner_top3_category_list":{"description":"Source-documented partner_top3_category_list; may be absent or null. Preserve the provider value and original monetary units."},"total_30d_video_live_gmv":{"description":"Source-documented total_30d_video_live_gmv; may be absent or null. Preserve the provider value and original monetary units."},"total_30d_video_live_sold_count":{"description":"Source-documented total_30d_video_live_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"total_related_creator_count":{"description":"Source-documented total_related_creator_count; may be absent or null. Preserve the provider value and original monetary units."},"total_related_product_count":{"description":"Source-documented total_related_product_count; may be absent or null. Preserve the provider value and original monetary units."},"total_related_seller_count":{"description":"Source-documented total_related_seller_count; may be absent or null. Preserve the provider value and original monetary units."},"video_count":{"description":"Source-documented video_count; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Creator Agencies. Known row fields: avg_commission_rate, follower_count, has_email_address, has_phone, has_whats_app, id, partner_icon, partner_id, partner_name, partner_top3_category, partner_top3_category_list, total_30d_video_live_gmv, total_30d_video_live_sold_count, total_related_creator_count, total_related_product_count, total_related_seller_count, video_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"avg_commission_rate":null,"follower_count":null,"has_email_address":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-creator-rankings-agencies","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_creator_rankings_agencies","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-search/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Creator Search","description":"Provider business records for TikTok Creator Search. Known row fields: account_type, author_avg_engagement_rate, bio_email, category_label, country_code, ecom_video_avg_play_count, facebook_url, follower_count, follower_count_growth_for_last_7_days, has_live_product, has_shop_product, has_video_product, id, ins_id, live_30d_gmv, live_30d_gpm, nickname, product_category_label_list, total_favorited, total_video_live_30d_gmv, unique_id, user_avatar, user_sell_product_l3_category, video_30d_gmv, video_30d_gpm, video_avg_like_count, video_avg_play_count, video_total_like_count_to_follower_count_ratio, youtube_channel_id. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokCreatorSearch","externalDocs":{"description":"Nexscope TikTok Creator Search documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creator-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":10,"example":5},"keyword":{"type":"string","description":"Creator search keyword.","example":"beauty"},"category":{"type":"string","description":"Creator category."},"hasContact":{"type":"boolean","description":"Filter by availability of public contact information.","example":true},"sort":{"type":"string","description":"Provider sort field and direction (field:asc or field:desc).","default":"gmv_30d:desc","pattern":"^[A-Za-z0-9_]+:(asc|desc)$","example":"gmv_30d:desc"},"minFollowers":{"type":"number","description":"Minimum follower count."},"maxFollowers":{"type":"number","description":"Maximum follower count."},"minGmv30d":{"type":"number","description":"Minimum 30-day GMV."},"maxGmv30d":{"type":"number","description":"Maximum 30-day GMV."},"minAvgViews":{"type":"number","description":"Minimum average view count."},"maxAvgViews":{"type":"number","description":"Maximum average view count."},"minEngagement":{"type":"number","description":"Minimum engagement rate."},"maxEngagement":{"type":"number","description":"Maximum engagement rate."}},"required":["country"]},"example":{"country":"us","keyword":"beauty","pageSize":5}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"account_type":{"description":"Source-documented account_type; may be absent or null. Preserve the provider value and original monetary units."},"author_avg_engagement_rate":{"description":"Source-documented author_avg_engagement_rate; may be absent or null. Preserve the provider value and original monetary units."},"bio_email":{"description":"Source-documented bio_email; may be absent or null. Preserve the provider value and original monetary units."},"category_label":{"description":"Source-documented category_label; may be absent or null. Preserve the provider value and original monetary units."},"country_code":{"description":"Source-documented country_code; may be absent or null. Preserve the provider value and original monetary units."},"ecom_video_avg_play_count":{"description":"Source-documented ecom_video_avg_play_count; may be absent or null. Preserve the provider value and original monetary units."},"facebook_url":{"description":"Source-documented facebook_url; may be absent or null. Preserve the provider value and original monetary units."},"follower_count":{"description":"Source-documented follower_count; may be absent or null. Preserve the provider value and original monetary units."},"follower_count_growth_for_last_7_days":{"description":"Source-documented follower_count_growth_for_last_7_days; may be absent or null. Preserve the provider value and original monetary units."},"has_live_product":{"description":"Source-documented has_live_product; may be absent or null. Preserve the provider value and original monetary units."},"has_shop_product":{"description":"Source-documented has_shop_product; may be absent or null. Preserve the provider value and original monetary units."},"has_video_product":{"description":"Source-documented has_video_product; may be absent or null. Preserve the provider value and original monetary units."},"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"ins_id":{"description":"Source-documented ins_id; may be absent or null. Preserve the provider value and original monetary units."},"live_30d_gmv":{"description":"Source-documented live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"live_30d_gpm":{"description":"Source-documented live_30d_gpm; may be absent or null. Preserve the provider value and original monetary units."},"nickname":{"description":"Source-documented nickname; may be absent or null. Preserve the provider value and original monetary units."},"product_category_label_list":{"description":"Source-documented product_category_label_list; may be absent or null. Preserve the provider value and original monetary units."},"total_favorited":{"description":"Source-documented total_favorited; may be absent or null. Preserve the provider value and original monetary units."},"total_video_live_30d_gmv":{"description":"Source-documented total_video_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"unique_id":{"description":"Source-documented unique_id; may be absent or null. Preserve the provider value and original monetary units."},"user_avatar":{"description":"Source-documented user_avatar; may be absent or null. Preserve the provider value and original monetary units."},"user_sell_product_l3_category":{"description":"Source-documented user_sell_product_l3_category; may be absent or null. Preserve the provider value and original monetary units."},"video_30d_gmv":{"description":"Source-documented video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"video_30d_gpm":{"description":"Source-documented video_30d_gpm; may be absent or null. Preserve the provider value and original monetary units."},"video_avg_like_count":{"description":"Source-documented video_avg_like_count; may be absent or null. Preserve the provider value and original monetary units."},"video_avg_play_count":{"description":"Source-documented video_avg_play_count; may be absent or null. Preserve the provider value and original monetary units."},"video_total_like_count_to_follower_count_ratio":{"description":"Source-documented video_total_like_count_to_follower_count_ratio; may be absent or null. Preserve the provider value and original monetary units."},"youtube_channel_id":{"description":"Source-documented youtube_channel_id; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Creator Search. Known row fields: account_type, author_avg_engagement_rate, bio_email, category_label, country_code, ecom_video_avg_play_count, facebook_url, follower_count, follower_count_growth_for_last_7_days, has_live_product, has_shop_product, has_video_product, id, ins_id, live_30d_gmv, live_30d_gpm, nickname, product_category_label_list, total_favorited, total_video_live_30d_gmv, unique_id, user_avatar, user_sell_product_l3_category, video_30d_gmv, video_30d_gpm, video_avg_like_count, video_avg_play_count, video_total_like_count_to_follower_count_ratio, youtube_channel_id. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"account_type":null,"author_avg_engagement_rate":null,"bio_email":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-creator-search","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_creator_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-rankings-top-selling/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Shop Top Selling","description":"Provider business records for TikTok Shop Top Selling. Known row fields: id, seller_id, shop_name, region, shop_rating, interval_sold_count, interval_gmv, interval_total_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokShopRankingsTopSelling","externalDocs":{"description":"Nexscope TikTok Shop Top Selling documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-shop-rankings-top-selling"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":20,"example":5},"date":{"type":"string","description":"Ranking date in YYYYMMDD format.","pattern":"^[0-9]{8}$","example":"20260824"},"granularity":{"type":"string","description":"Ranking period.","enum":["daily","weekly","monthly","0","1","2"],"example":"daily"},"category":{"type":"string","description":"Product category ID."},"shopType":{"type":"string","description":"Provider shop type.","enum":["1","2","3","4"]},"sort":{"type":"string","description":"Provider sort field and direction (field:asc or field:desc).","default":"interval_sold_count:desc","pattern":"^[A-Za-z0-9_]+:(asc|desc)$","example":"interval_sold_count:desc"}},"required":["country","date","granularity"]},"example":{"country":"us","date":"20260824","granularity":"daily","pageSize":10}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"seller_id":{"description":"Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units."},"shop_name":{"description":"Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."},"region":{"description":"Source-documented region; may be absent or null. Preserve the provider value and original monetary units."},"shop_rating":{"description":"Source-documented shop_rating; may be absent or null. Preserve the provider value and original monetary units."},"shop_product_count":{"description":"Source-documented shop_product_count; may be absent or null. Preserve the provider value and original monetary units."},"seller_main_category":{"description":"Source-documented seller_main_category; may be absent or null. Preserve the provider value and original monetary units."},"seller_business_info":{"description":"Source-documented seller_business_info; may be absent or null. Preserve the provider value and original monetary units."},"seller_avatar":{"description":"Source-documented seller_avatar; may be absent or null. Preserve the provider value and original monetary units."},"biz_type":{"description":"Source-documented biz_type; may be absent or null. Preserve the provider value and original monetary units."},"interval_sold_count":{"description":"Source-documented interval_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"interval_total_sold_count":{"description":"Source-documented interval_total_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"interval_sold_count_growth_rate":{"description":"Source-documented interval_sold_count_growth_rate; may be absent or null. Preserve the provider value and original monetary units."},"interval_gmv":{"description":"Source-documented interval_gmv; may be absent or null. Preserve the provider value and original monetary units."},"interval_total_gmv":{"description":"Source-documented interval_total_gmv; may be absent or null. Preserve the provider value and original monetary units."},"interval_gmv_pop_growth_rate":{"description":"Source-documented interval_gmv_pop_growth_rate; may be absent or null. Preserve the provider value and original monetary units."},"interval_related_creator_count":{"description":"Source-documented interval_related_creator_count; may be absent or null. Preserve the provider value and original monetary units."},"interval_total_related_creator_count":{"description":"Source-documented interval_total_related_creator_count; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Shop Top Selling. Known row fields: id, seller_id, shop_name, region, shop_rating, interval_sold_count, interval_gmv, interval_total_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"seller_id":null,"shop_name":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-shop-rankings-top-selling","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_shop_rankings_top_selling","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-rankings-most-promoted/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Shop Most Promoted","description":"Provider business records for TikTok Shop Most Promoted. Known row fields: id, seller_id, shop_name, region, shop_rating, interval_related_creator_count, interval_total_related_creator_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokShopRankingsMostPromoted","externalDocs":{"description":"Nexscope TikTok Shop Most Promoted documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-shop-rankings-most-promoted"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":20,"example":5},"date":{"type":"string","description":"Ranking date in YYYYMMDD format.","pattern":"^[0-9]{8}$","example":"20260824"},"granularity":{"type":"string","description":"Ranking period.","enum":["daily","weekly","monthly","0","1","2"],"example":"daily"},"category":{"type":"string","description":"Product category ID."},"shopType":{"type":"string","description":"Provider shop type.","enum":["1","2","3","4"]},"sort":{"type":"string","description":"Provider sort field and direction (field:asc or field:desc).","default":"related_creator_count:desc","pattern":"^[A-Za-z0-9_]+:(asc|desc)$","example":"related_creator_count:desc"}},"required":["country","date","granularity"]},"example":{"country":"us","date":"20260824","granularity":"daily","pageSize":10}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"seller_id":{"description":"Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units."},"shop_name":{"description":"Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."},"region":{"description":"Source-documented region; may be absent or null. Preserve the provider value and original monetary units."},"shop_rating":{"description":"Source-documented shop_rating; may be absent or null. Preserve the provider value and original monetary units."},"shop_product_count":{"description":"Source-documented shop_product_count; may be absent or null. Preserve the provider value and original monetary units."},"seller_main_category":{"description":"Source-documented seller_main_category; may be absent or null. Preserve the provider value and original monetary units."},"seller_business_info":{"description":"Source-documented seller_business_info; may be absent or null. Preserve the provider value and original monetary units."},"seller_avatar":{"description":"Source-documented seller_avatar; may be absent or null. Preserve the provider value and original monetary units."},"biz_type":{"description":"Source-documented biz_type; may be absent or null. Preserve the provider value and original monetary units."},"interval_related_creator_count":{"description":"Source-documented interval_related_creator_count; may be absent or null. Preserve the provider value and original monetary units."},"interval_total_related_creator_count":{"description":"Source-documented interval_total_related_creator_count; may be absent or null. Preserve the provider value and original monetary units."},"interval_total_related_video_creator_count":{"description":"Source-documented interval_total_related_video_creator_count; may be absent or null. Preserve the provider value and original monetary units."},"interval_total_related_shop_creator_count":{"description":"Source-documented interval_total_related_shop_creator_count; may be absent or null. Preserve the provider value and original monetary units."},"interval_total_related_videos_count":{"description":"Source-documented interval_total_related_videos_count; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Shop Most Promoted. Known row fields: id, seller_id, shop_name, region, shop_rating, interval_related_creator_count, interval_total_related_creator_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"seller_id":null,"shop_name":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-shop-rankings-most-promoted","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_shop_rankings_most_promoted","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-search/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Shop Search","description":"Provider business records for TikTok Shop Search. Known row fields: id, shop_name, region, shop_rating, shop_product_count, shop_total_sold_count, shop_total_gmv, shop_sold_count_for_last_7_days, shop_gmv_for_last_7_days. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokShopSearch","externalDocs":{"description":"Nexscope TikTok Shop Search documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-shop-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":10,"example":5},"keyword":{"type":"string","description":"Shop search keyword.","example":"beauty"},"category":{"type":"string","description":"Product category ID."},"sellerType":{"type":"string","description":"Provider-supported seller type."},"sort":{"type":"string","description":"Provider sort field and direction (field:asc or field:desc).","default":"gmv_7d:desc","pattern":"^[A-Za-z0-9_]+:(asc|desc)$","example":"gmv_7d:desc"},"minRating":{"type":"number","description":"Minimum shop rating."},"maxRating":{"type":"number","description":"Maximum shop rating."},"minSold7d":{"type":"number","description":"Minimum 7-day sales."},"maxSold7d":{"type":"number","description":"Maximum 7-day sales."},"minGmv7d":{"type":"number","description":"Minimum 7-day GMV."},"maxGmv7d":{"type":"number","description":"Maximum 7-day GMV."}},"required":["country"]},"example":{"country":"us","keyword":"beauty","minRating":4,"pageSize":3}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"shop_name":{"description":"Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."},"region":{"description":"Source-documented region; may be absent or null. Preserve the provider value and original monetary units."},"shop_rating":{"description":"Source-documented shop_rating; may be absent or null. Preserve the provider value and original monetary units."},"shop_product_count":{"description":"Source-documented shop_product_count; may be absent or null. Preserve the provider value and original monetary units."},"shop_total_sold_count":{"description":"Source-documented shop_total_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"shop_total_gmv":{"description":"Source-documented shop_total_gmv; may be absent or null. Preserve the provider value and original monetary units."},"shop_sold_count_for_last_7_days":{"description":"Source-documented shop_sold_count_for_last_7_days; may be absent or null. Preserve the provider value and original monetary units."},"shop_gmv_for_last_7_days":{"description":"Source-documented shop_gmv_for_last_7_days; may be absent or null. Preserve the provider value and original monetary units."},"shop_main_category":{"description":"Source-documented shop_main_category; may be absent or null. Preserve the provider value and original monetary units."},"total_related_creator_count":{"description":"Source-documented total_related_creator_count; may be absent or null. Preserve the provider value and original monetary units."},"seller_business_info":{"description":"Source-documented seller_business_info; may be absent or null. Preserve the provider value and original monetary units."},"sold_count_trend":{"description":"Source-documented sold_count_trend; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Shop Search. Known row fields: id, shop_name, region, shop_rating, shop_product_count, shop_total_sold_count, shop_total_gmv, shop_sold_count_for_last_7_days, shop_gmv_for_last_7_days. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"shop_name":null,"region":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-shop-search","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_shop_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-product-image-search/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Product Image Search","description":"Provider business records for TikTok Product Image Search. Known row fields: id, product_name, product_images, floor_price, ceiling_price, product_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokProductImageSearch","externalDocs":{"description":"Nexscope TikTok Product Image Search documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-image-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"osKey":{"type":"string","description":"osKey returned after uploading the image through the Nexscope provider upload flow; obtain this value before calling.","minLength":1},"country":{"type":"string","description":"Uppercase two-letter market code.","default":"US","pattern":"^[A-Z]{2}$","example":"US"}},"required":["osKey"]},"example":{"osKey":"REPLACE_WITH_UPLOADED_OS_KEY","country":"US"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"product_id":{"description":"Source-documented product_id; may be absent or null. Preserve the provider value and original monetary units."},"product_name":{"description":"Source-documented product_name; may be absent or null. Preserve the provider value and original monetary units."},"product_images":{"description":"Source-documented product_images; may be absent or null. Preserve the provider value and original monetary units."},"floor_price":{"description":"Source-documented floor_price; may be absent or null. Preserve the provider value and original monetary units."},"ceiling_price":{"description":"Source-documented ceiling_price; may be absent or null. Preserve the provider value and original monetary units."},"product_rating":{"description":"Source-documented product_rating; may be absent or null. Preserve the provider value and original monetary units."},"product_sold_count":{"description":"Source-documented product_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"product_gmv":{"description":"Source-documented product_gmv; may be absent or null. Preserve the provider value and original monetary units."},"product_l1_category":{"description":"Source-documented product_l1_category; may be absent or null. Preserve the provider value and original monetary units."},"product_l2_category":{"description":"Source-documented product_l2_category; may be absent or null. Preserve the provider value and original monetary units."},"product_l3_category":{"description":"Source-documented product_l3_category; may be absent or null. Preserve the provider value and original monetary units."},"country_code":{"description":"Source-documented country_code; may be absent or null. Preserve the provider value and original monetary units."},"region":{"description":"Source-documented region; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Product Image Search. Known row fields: id, product_name, product_images, floor_price, ceiling_price, product_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"product_id":null,"product_name":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-product-image-search","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_product_image_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-product-rankings-new-arrivals/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Product New Arrivals","description":"Provider business records for TikTok Product New Arrivals. Known row fields: id, product_id, product_name, shop_name, total_gmv, total_sold_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokProductRankingsNewArrivals","externalDocs":{"description":"Nexscope TikTok Product New Arrivals documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-rankings-new-arrivals"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":20,"example":5},"category":{"type":"string","description":"Product category ID."},"sellerType":{"type":"string","description":"Seller type.","enum":["1","2","3","4"]},"sort":{"type":"string","description":"Provider sort field and direction (field:asc or field:desc).","default":"gmv_3d:desc","pattern":"^(gmv_3d|sold_count_3d|total_gmv|total_sold_count):(asc|desc)$","example":"gmv_3d:desc"},"listedFrom":{"type":"string","description":"Earliest listing date in YYYYMMDD format.","pattern":"^[0-9]{8}$"},"listedTo":{"type":"string","description":"Latest listing date in YYYYMMDD format.","pattern":"^[0-9]{8}$"},"productStatus":{"type":"string","description":"Provider product status.","enum":["1","2","3","4"]}},"required":["country"]},"example":{"country":"us","pageSize":10}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"product_id":{"description":"Source-documented product_id; may be absent or null. Preserve the provider value and original monetary units."},"product_name":{"description":"Source-documented product_name; may be absent or null. Preserve the provider value and original monetary units."},"product_images":{"description":"Source-documented product_images; may be absent or null. Preserve the provider value and original monetary units."},"shop_name":{"description":"Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."},"seller_id":{"description":"Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units."},"floor_price":{"description":"Source-documented floor_price; may be absent or null. Preserve the provider value and original monetary units."},"ceiling_price":{"description":"Source-documented ceiling_price; may be absent or null. Preserve the provider value and original monetary units."},"product_rating":{"description":"Source-documented product_rating; may be absent or null. Preserve the provider value and original monetary units."},"total_gmv":{"description":"Source-documented total_gmv; may be absent or null. Preserve the provider value and original monetary units."},"total_sold_count":{"description":"Source-documented total_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"gmv_3d":{"description":"Source-documented gmv_3d; may be absent or null. Preserve the provider value and original monetary units."},"sold_count_3d":{"description":"Source-documented sold_count_3d; may be absent or null. Preserve the provider value and original monetary units."},"gmv_7d":{"description":"Source-documented gmv_7d; may be absent or null. Preserve the provider value and original monetary units."},"sold_count_7d":{"description":"Source-documented sold_count_7d; may be absent or null. Preserve the provider value and original monetary units."},"product_status":{"description":"Source-documented product_status; may be absent or null. Preserve the provider value and original monetary units."},"create_time":{"description":"Source-documented create_time; may be absent or null. Preserve the provider value and original monetary units."},"sold_count_trend":{"description":"Source-documented sold_count_trend; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Product New Arrivals. Known row fields: id, product_id, product_name, shop_name, total_gmv, total_sold_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"product_id":null,"product_name":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-product-rankings-new-arrivals","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_product_rankings_new_arrivals","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-product-rankings-top-selling/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Product Top Selling","description":"Provider business records for TikTok Product Top Selling. Known row fields: id, product_id, product_name, shop_name, interval_gmv, interval_sold_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokProductRankingsTopSelling","externalDocs":{"description":"Nexscope TikTok Product Top Selling documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-rankings-top-selling"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":20,"example":5},"date":{"type":"string","description":"Ranking date in YYYYMMDD format.","pattern":"^[0-9]{8}$","example":"20260824"},"granularity":{"type":"string","description":"Ranking period.","enum":["daily","weekly","monthly","0","1","2"],"example":"daily"},"category":{"type":"string","description":"Product category ID."},"sellerType":{"type":"string","description":"Seller type.","enum":["1","2","3","4"]},"sort":{"type":"string","description":"Provider sort field and direction (field:asc or field:desc).","default":"interval_sold_count:desc","pattern":"^(gmv_growth_rate|interval_gmv|interval_sold_count|sold_count_growth_rate|total_gmv|total_sold_count):(asc|desc)$","example":"interval_sold_count:desc"}},"required":["country","date","granularity"]},"example":{"country":"us","pageSize":10,"date":"20260824","granularity":"daily"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"product_id":{"description":"Source-documented product_id; may be absent or null. Preserve the provider value and original monetary units."},"product_name":{"description":"Source-documented product_name; may be absent or null. Preserve the provider value and original monetary units."},"product_images":{"description":"Source-documented product_images; may be absent or null. Preserve the provider value and original monetary units."},"shop_name":{"description":"Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."},"seller_id":{"description":"Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units."},"floor_price":{"description":"Source-documented floor_price; may be absent or null. Preserve the provider value and original monetary units."},"ceiling_price":{"description":"Source-documented ceiling_price; may be absent or null. Preserve the provider value and original monetary units."},"product_rating":{"description":"Source-documented product_rating; may be absent or null. Preserve the provider value and original monetary units."},"interval_gmv":{"description":"Source-documented interval_gmv; may be absent or null. Preserve the provider value and original monetary units."},"interval_sold_count":{"description":"Source-documented interval_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"total_gmv":{"description":"Source-documented total_gmv; may be absent or null. Preserve the provider value and original monetary units."},"total_sold_count":{"description":"Source-documented total_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"gmv_growth_rate":{"description":"Source-documented gmv_growth_rate; may be absent or null. Preserve the provider value and original monetary units."},"sold_count_growth_rate":{"description":"Source-documented sold_count_growth_rate; may be absent or null. Preserve the provider value and original monetary units."},"live_count":{"description":"Source-documented live_count; may be absent or null. Preserve the provider value and original monetary units."},"related_creator_count":{"description":"Source-documented related_creator_count; may be absent or null. Preserve the provider value and original monetary units."},"video_play_count":{"description":"Source-documented video_play_count; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Product Top Selling. Known row fields: id, product_id, product_name, shop_name, interval_gmv, interval_sold_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"product_id":null,"product_name":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-product-rankings-top-selling","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_product_rankings_top_selling","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-product-rankings-most-promoted/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Product Most Promoted","description":"Provider business records for TikTok Product Most Promoted. Known row fields: id, product_id, product_name, shop_name, interval_gmv, interval_sold_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokProductRankingsMostPromoted","externalDocs":{"description":"Nexscope TikTok Product Most Promoted documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-rankings-most-promoted"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":20,"example":5},"date":{"type":"string","description":"Ranking date in YYYYMMDD format.","pattern":"^[0-9]{8}$","example":"20260824"},"granularity":{"type":"string","description":"Ranking period.","enum":["daily","weekly","monthly","0","1","2"],"example":"daily"},"category":{"type":"string","description":"Product category ID."},"sellerType":{"type":"string","description":"Seller type.","enum":["1","2","3","4"]},"sort":{"type":"string","description":"Provider sort field and direction (field:asc or field:desc).","default":"related_creator_count:desc","pattern":"^(interval_gmv|interval_sold_count|live_count|live_user_count|related_creator_count|video_play_count):(asc|desc)$","example":"related_creator_count:desc"}},"required":["country","date","granularity"]},"example":{"country":"us","pageSize":10,"date":"20260824","granularity":"daily"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"product_id":{"description":"Source-documented product_id; may be absent or null. Preserve the provider value and original monetary units."},"product_name":{"description":"Source-documented product_name; may be absent or null. Preserve the provider value and original monetary units."},"product_images":{"description":"Source-documented product_images; may be absent or null. Preserve the provider value and original monetary units."},"shop_name":{"description":"Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."},"seller_id":{"description":"Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units."},"floor_price":{"description":"Source-documented floor_price; may be absent or null. Preserve the provider value and original monetary units."},"ceiling_price":{"description":"Source-documented ceiling_price; may be absent or null. Preserve the provider value and original monetary units."},"interval_gmv":{"description":"Source-documented interval_gmv; may be absent or null. Preserve the provider value and original monetary units."},"interval_sold_count":{"description":"Source-documented interval_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"live_count":{"description":"Source-documented live_count; may be absent or null. Preserve the provider value and original monetary units."},"live_user_count":{"description":"Source-documented live_user_count; may be absent or null. Preserve the provider value and original monetary units."},"related_creator_count":{"description":"Source-documented related_creator_count; may be absent or null. Preserve the provider value and original monetary units."},"video_play_count":{"description":"Source-documented video_play_count; may be absent or null. Preserve the provider value and original monetary units."},"product_rating":{"description":"Source-documented product_rating; may be absent or null. Preserve the provider value and original monetary units."},"product_status":{"description":"Source-documented product_status; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Product Most Promoted. Known row fields: id, product_id, product_name, shop_name, interval_gmv, interval_sold_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"product_id":null,"product_name":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-product-rankings-most-promoted","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_product_rankings_most_promoted","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-related-videos/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Creator Related Videos","description":"Provider business records for TikTok Creator Related Videos. Known row fields: id, tiktok_creator_detail_is_ad, tiktok_creator_detail_is_aigc_video, tiktok_creator_detail_video_30d_gmv, tiktok_creator_detail_video_30d_sold_count, tiktok_creator_detail_video_ad_source, tiktok_creator_detail_video_author_category_label, tiktok_creator_detail_video_author_nickname, tiktok_creator_detail_video_author_uid, tiktok_creator_detail_video_author_unique_id, tiktok_creator_detail_video_collect_count, tiktok_creator_detail_video_comment_count, tiktok_creator_detail_video_country_code, tiktok_creator_detail_video_cover, tiktok_creator_detail_video_desc, tiktok_creator_detail_video_duration, tiktok_creator_detail_video_engagement_rate, tiktok_creator_detail_video_id, tiktok_creator_detail_video_launch_time, tiktok_creator_detail_video_like_count, tiktok_creator_detail_video_play_count, tiktok_creator_detail_video_product_id, tiktok_creator_detail_video_product_images, tiktok_creator_detail_video_product_l1_category, tiktok_creator_detail_video_product_l2_category, tiktok_creator_detail_video_product_l3_category, tiktok_creator_detail_video_product_title, tiktok_creator_detail_video_share_count, tiktok_creator_detail_video_share_url, tiktok_creator_detail_video_total_like_count_to_follower_count_ratio, tiktok_creator_detail_video_user_avatar. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokCreatorRelatedVideos","externalDocs":{"description":"Nexscope TikTok Creator Related Videos documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creator-related-videos"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":10,"example":5},"id":{"type":"string","description":"Creator ID, preserved as a string.","minLength":1,"example":"7302162228386776110"}},"required":["country","id"]},"example":{"country":"us","id":"7302162228386776110","page":1,"pageSize":5}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_is_ad":{"description":"Source-documented tiktok_creator_detail_is_ad; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_is_aigc_video":{"description":"Source-documented tiktok_creator_detail_is_aigc_video; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_30d_gmv":{"description":"Source-documented tiktok_creator_detail_video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_30d_sold_count":{"description":"Source-documented tiktok_creator_detail_video_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_ad_source":{"description":"Source-documented tiktok_creator_detail_video_ad_source; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_author_category_label":{"description":"Source-documented tiktok_creator_detail_video_author_category_label; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_author_nickname":{"description":"Source-documented tiktok_creator_detail_video_author_nickname; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_author_uid":{"description":"Source-documented tiktok_creator_detail_video_author_uid; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_author_unique_id":{"description":"Source-documented tiktok_creator_detail_video_author_unique_id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_collect_count":{"description":"Source-documented tiktok_creator_detail_video_collect_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_comment_count":{"description":"Source-documented tiktok_creator_detail_video_comment_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_country_code":{"description":"Source-documented tiktok_creator_detail_video_country_code; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_cover":{"description":"Source-documented tiktok_creator_detail_video_cover; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_desc":{"description":"Source-documented tiktok_creator_detail_video_desc; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_duration":{"description":"Source-documented tiktok_creator_detail_video_duration; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_engagement_rate":{"description":"Source-documented tiktok_creator_detail_video_engagement_rate; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_id":{"description":"Source-documented tiktok_creator_detail_video_id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_launch_time":{"description":"Source-documented tiktok_creator_detail_video_launch_time; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_like_count":{"description":"Source-documented tiktok_creator_detail_video_like_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_play_count":{"description":"Source-documented tiktok_creator_detail_video_play_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_product_id":{"description":"Source-documented tiktok_creator_detail_video_product_id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_product_images":{"description":"Source-documented tiktok_creator_detail_video_product_images; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_product_l1_category":{"description":"Source-documented tiktok_creator_detail_video_product_l1_category; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_product_l2_category":{"description":"Source-documented tiktok_creator_detail_video_product_l2_category; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_product_l3_category":{"description":"Source-documented tiktok_creator_detail_video_product_l3_category; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_product_title":{"description":"Source-documented tiktok_creator_detail_video_product_title; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_share_count":{"description":"Source-documented tiktok_creator_detail_video_share_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_share_url":{"description":"Source-documented tiktok_creator_detail_video_share_url; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_total_like_count_to_follower_count_ratio":{"description":"Source-documented tiktok_creator_detail_video_total_like_count_to_follower_count_ratio; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_user_avatar":{"description":"Source-documented tiktok_creator_detail_video_user_avatar; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Creator Related Videos. Known row fields: id, tiktok_creator_detail_is_ad, tiktok_creator_detail_is_aigc_video, tiktok_creator_detail_video_30d_gmv, tiktok_creator_detail_video_30d_sold_count, tiktok_creator_detail_video_ad_source, tiktok_creator_detail_video_author_category_label, tiktok_creator_detail_video_author_nickname, tiktok_creator_detail_video_author_uid, tiktok_creator_detail_video_author_unique_id, tiktok_creator_detail_video_collect_count, tiktok_creator_detail_video_comment_count, tiktok_creator_detail_video_country_code, tiktok_creator_detail_video_cover, tiktok_creator_detail_video_desc, tiktok_creator_detail_video_duration, tiktok_creator_detail_video_engagement_rate, tiktok_creator_detail_video_id, tiktok_creator_detail_video_launch_time, tiktok_creator_detail_video_like_count, tiktok_creator_detail_video_play_count, tiktok_creator_detail_video_product_id, tiktok_creator_detail_video_product_images, tiktok_creator_detail_video_product_l1_category, tiktok_creator_detail_video_product_l2_category, tiktok_creator_detail_video_product_l3_category, tiktok_creator_detail_video_product_title, tiktok_creator_detail_video_share_count, tiktok_creator_detail_video_share_url, tiktok_creator_detail_video_total_like_count_to_follower_count_ratio, tiktok_creator_detail_video_user_avatar. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"tiktok_creator_detail_is_ad":null,"tiktok_creator_detail_is_aigc_video":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-creator-related-videos","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_creator_related_videos","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-related-products/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Creator Related Products","description":"Provider business records for TikTok Creator Related Products. Known row fields: id, tiktok_creator_detail_by_live, tiktok_creator_detail_by_shop, tiktok_creator_detail_by_video, tiktok_creator_detail_live_30d_gmv, tiktok_creator_detail_live_30d_sold_count, tiktok_creator_detail_product_country_code, tiktok_creator_detail_product_id, tiktok_creator_detail_product_launch_time, tiktok_creator_detail_total_video_live_30d_gmv, tiktok_creator_detail_total_video_live_30d_sold_count, tiktok_creator_detail_user_id, tiktok_creator_detail_video_30d_gmv, tiktok_creator_detail_video_30d_sold_count, tiktok_product_detail_ceiling_price, tiktok_product_detail_commission_rate, tiktok_product_detail_floor_price, tiktok_product_detail_l1_category, tiktok_product_detail_l2_category, tiktok_product_detail_l3_category, tiktok_product_detail_product_images, tiktok_product_detail_product_name, tiktok_product_detail_product_rating, tiktok_product_detail_product_sku_props, tiktok_product_detail_product_skus, tiktok_product_detail_product_status, tiktok_product_detail_region. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokCreatorRelatedProducts","externalDocs":{"description":"Nexscope TikTok Creator Related Products documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creator-related-products"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":10,"example":5},"id":{"type":"string","description":"Creator ID, preserved as a string.","minLength":1,"example":"7302162228386776110"}},"required":["country","id"]},"example":{"country":"us","id":"7302162228386776110","page":1,"pageSize":5}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_by_live":{"description":"Source-documented tiktok_creator_detail_by_live; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_by_shop":{"description":"Source-documented tiktok_creator_detail_by_shop; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_by_video":{"description":"Source-documented tiktok_creator_detail_by_video; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_30d_gmv":{"description":"Source-documented tiktok_creator_detail_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_30d_sold_count":{"description":"Source-documented tiktok_creator_detail_live_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_product_country_code":{"description":"Source-documented tiktok_creator_detail_product_country_code; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_product_id":{"description":"Source-documented tiktok_creator_detail_product_id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_product_launch_time":{"description":"Source-documented tiktok_creator_detail_product_launch_time; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_total_video_live_30d_gmv":{"description":"Source-documented tiktok_creator_detail_total_video_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_total_video_live_30d_sold_count":{"description":"Source-documented tiktok_creator_detail_total_video_live_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_user_id":{"description":"Source-documented tiktok_creator_detail_user_id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_30d_gmv":{"description":"Source-documented tiktok_creator_detail_video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_video_30d_sold_count":{"description":"Source-documented tiktok_creator_detail_video_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_product_detail_ceiling_price":{"description":"Source-documented tiktok_product_detail_ceiling_price; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_product_detail_commission_rate":{"description":"Source-documented tiktok_product_detail_commission_rate; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_product_detail_floor_price":{"description":"Source-documented tiktok_product_detail_floor_price; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_product_detail_l1_category":{"description":"Source-documented tiktok_product_detail_l1_category; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_product_detail_l2_category":{"description":"Source-documented tiktok_product_detail_l2_category; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_product_detail_l3_category":{"description":"Source-documented tiktok_product_detail_l3_category; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_product_detail_product_images":{"description":"Source-documented tiktok_product_detail_product_images; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_product_detail_product_name":{"description":"Source-documented tiktok_product_detail_product_name; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_product_detail_product_rating":{"description":"Source-documented tiktok_product_detail_product_rating; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_product_detail_product_sku_props":{"description":"Source-documented tiktok_product_detail_product_sku_props; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_product_detail_product_skus":{"description":"Source-documented tiktok_product_detail_product_skus; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_product_detail_product_status":{"description":"Source-documented tiktok_product_detail_product_status; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_product_detail_region":{"description":"Source-documented tiktok_product_detail_region; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Creator Related Products. Known row fields: id, tiktok_creator_detail_by_live, tiktok_creator_detail_by_shop, tiktok_creator_detail_by_video, tiktok_creator_detail_live_30d_gmv, tiktok_creator_detail_live_30d_sold_count, tiktok_creator_detail_product_country_code, tiktok_creator_detail_product_id, tiktok_creator_detail_product_launch_time, tiktok_creator_detail_total_video_live_30d_gmv, tiktok_creator_detail_total_video_live_30d_sold_count, tiktok_creator_detail_user_id, tiktok_creator_detail_video_30d_gmv, tiktok_creator_detail_video_30d_sold_count, tiktok_product_detail_ceiling_price, tiktok_product_detail_commission_rate, tiktok_product_detail_floor_price, tiktok_product_detail_l1_category, tiktok_product_detail_l2_category, tiktok_product_detail_l3_category, tiktok_product_detail_product_images, tiktok_product_detail_product_name, tiktok_product_detail_product_rating, tiktok_product_detail_product_sku_props, tiktok_product_detail_product_skus, tiktok_product_detail_product_status, tiktok_product_detail_region. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"tiktok_creator_detail_by_live":null,"tiktok_creator_detail_by_shop":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-creator-related-products","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_creator_related_products","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-related-lives/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Creator Related Lives","description":"Provider business records for TikTok Creator Related Lives. Known row fields: id, tiktok_creator_detail_live_country_code, tiktok_creator_detail_live_cover, tiktok_creator_detail_live_end_time, tiktok_creator_detail_live_gmv, tiktok_creator_detail_live_gpm, tiktok_creator_detail_live_max_user_count, tiktok_creator_detail_live_most_product_category_label, tiktok_creator_detail_live_new_follow_count, tiktok_creator_detail_live_opm, tiktok_creator_detail_live_product_count, tiktok_creator_detail_live_room_id, tiktok_creator_detail_live_room_link, tiktok_creator_detail_live_start_time, tiktok_creator_detail_live_title, tiktok_creator_detail_live_total_sold_count, tiktok_creator_detail_live_total_user, tiktok_creator_detail_live_user_follower_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokCreatorRelatedLives","externalDocs":{"description":"Nexscope TikTok Creator Related Lives documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creator-related-lives"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":10,"example":5},"id":{"type":"string","description":"Creator ID, preserved as a string.","minLength":1,"example":"7302162228386776110"}},"required":["country","id"]},"example":{"country":"us","id":"7302162228386776110","page":1,"pageSize":5}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_country_code":{"description":"Source-documented tiktok_creator_detail_live_country_code; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_cover":{"description":"Source-documented tiktok_creator_detail_live_cover; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_end_time":{"description":"Source-documented tiktok_creator_detail_live_end_time; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_gmv":{"description":"Source-documented tiktok_creator_detail_live_gmv; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_gpm":{"description":"Source-documented tiktok_creator_detail_live_gpm; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_max_user_count":{"description":"Source-documented tiktok_creator_detail_live_max_user_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_most_product_category_label":{"description":"Source-documented tiktok_creator_detail_live_most_product_category_label; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_new_follow_count":{"description":"Source-documented tiktok_creator_detail_live_new_follow_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_opm":{"description":"Source-documented tiktok_creator_detail_live_opm; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_product_count":{"description":"Source-documented tiktok_creator_detail_live_product_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_room_id":{"description":"Source-documented tiktok_creator_detail_live_room_id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_room_link":{"description":"Source-documented tiktok_creator_detail_live_room_link; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_start_time":{"description":"Source-documented tiktok_creator_detail_live_start_time; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_title":{"description":"Source-documented tiktok_creator_detail_live_title; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_total_sold_count":{"description":"Source-documented tiktok_creator_detail_live_total_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_total_user":{"description":"Source-documented tiktok_creator_detail_live_total_user; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_creator_detail_live_user_follower_count":{"description":"Source-documented tiktok_creator_detail_live_user_follower_count; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Creator Related Lives. Known row fields: id, tiktok_creator_detail_live_country_code, tiktok_creator_detail_live_cover, tiktok_creator_detail_live_end_time, tiktok_creator_detail_live_gmv, tiktok_creator_detail_live_gpm, tiktok_creator_detail_live_max_user_count, tiktok_creator_detail_live_most_product_category_label, tiktok_creator_detail_live_new_follow_count, tiktok_creator_detail_live_opm, tiktok_creator_detail_live_product_count, tiktok_creator_detail_live_room_id, tiktok_creator_detail_live_room_link, tiktok_creator_detail_live_start_time, tiktok_creator_detail_live_title, tiktok_creator_detail_live_total_sold_count, tiktok_creator_detail_live_total_user, tiktok_creator_detail_live_user_follower_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"tiktok_creator_detail_live_country_code":null,"tiktok_creator_detail_live_cover":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-creator-related-lives","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_creator_related_lives","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-related-videos/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Shop Related Videos","description":"Provider business records for TikTok Shop Related Videos. Known row fields: id, tiktok_seller_detail_video_id, tiktok_seller_detail_video_desc, tiktok_seller_detail_video_play_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokShopRelatedVideos","externalDocs":{"description":"Nexscope TikTok Shop Related Videos documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-shop-related-videos"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":10,"example":5},"id":{"type":"string","description":"Shop ID, preserved as a string.","minLength":1,"example":"7495205878591949358"}},"required":["country","id"]},"example":{"country":"us","id":"7495205878591949358","page":1,"pageSize":5}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_video_id":{"description":"Source-documented tiktok_seller_detail_video_id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_video_seller_id":{"description":"Source-documented tiktok_seller_detail_video_seller_id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_video_desc":{"description":"Source-documented tiktok_seller_detail_video_desc; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_share_url":{"description":"Source-documented tiktok_seller_detail_share_url; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_cover_url":{"description":"Source-documented tiktok_seller_detail_cover_url; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_video_launch_time":{"description":"Source-documented tiktok_seller_detail_video_launch_time; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_video_duration":{"description":"Source-documented tiktok_seller_detail_video_duration; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_video_play_count":{"description":"Source-documented tiktok_seller_detail_video_play_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_video_30d_play_count":{"description":"Source-documented tiktok_seller_detail_video_30d_play_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_video_like_count":{"description":"Source-documented tiktok_seller_detail_video_like_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_video_comment_count":{"description":"Source-documented tiktok_seller_detail_video_comment_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_video_engagement_rate":{"description":"Source-documented tiktok_seller_detail_video_engagement_rate; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_video_30d_sold_count":{"description":"Source-documented tiktok_seller_detail_video_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_video_30d_gmv":{"description":"Source-documented tiktok_seller_detail_video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_is_ad":{"description":"Source-documented tiktok_seller_detail_is_ad; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_is_aigc_video":{"description":"Source-documented tiktok_seller_detail_is_aigc_video; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_video_ad_source":{"description":"Source-documented tiktok_seller_detail_video_ad_source; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_user_id":{"description":"Source-documented tiktok_seller_detail_user_id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_user_unique_id":{"description":"Source-documented tiktok_seller_detail_user_unique_id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_user_nickname":{"description":"Source-documented tiktok_seller_detail_user_nickname; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_user_avatar":{"description":"Source-documented tiktok_seller_detail_user_avatar; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_follower_count":{"description":"Source-documented tiktok_seller_detail_follower_count; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Shop Related Videos. Known row fields: id, tiktok_seller_detail_video_id, tiktok_seller_detail_video_desc, tiktok_seller_detail_video_play_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"tiktok_seller_detail_video_id":null,"tiktok_seller_detail_video_seller_id":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-shop-related-videos","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_shop_related_videos","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-related-products/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Shop Related Products","description":"Provider business records for TikTok Shop Related Products. Known row fields: id, tiktok_seller_product_product_id, tiktok_seller_product_product_name, tiktok_seller_product_product_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokShopRelatedProducts","externalDocs":{"description":"Nexscope TikTok Shop Related Products documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-shop-related-products"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":10,"example":5},"id":{"type":"string","description":"Shop ID, preserved as a string.","minLength":1,"example":"7495205878591949358"}},"required":["country","id"]},"example":{"country":"us","id":"7495205878591949358","page":1,"pageSize":5}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_product_id":{"description":"Source-documented tiktok_seller_product_product_id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_product_name":{"description":"Source-documented tiktok_seller_product_product_name; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_product_link":{"description":"Source-documented tiktok_seller_detail_product_link; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_product_detail_link":{"description":"Source-documented tiktok_seller_detail_product_detail_link; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_region":{"description":"Source-documented tiktok_seller_product_region; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_product_status":{"description":"Source-documented tiktok_seller_product_product_status; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_l1_category":{"description":"Source-documented tiktok_seller_product_l1_category; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_l2_category":{"description":"Source-documented tiktok_seller_product_l2_category; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_l3_category":{"description":"Source-documented tiktok_seller_product_l3_category; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_create_time":{"description":"Source-documented tiktok_seller_product_create_time; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_product_sold_count":{"description":"Source-documented tiktok_seller_product_product_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_product_sold_count_for_last_7_days":{"description":"Source-documented tiktok_seller_product_product_sold_count_for_last_7_days; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_product_gmv":{"description":"Source-documented tiktok_seller_product_product_gmv; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_product_gmv_for_last_7_days":{"description":"Source-documented tiktok_seller_product_product_gmv_for_last_7_days; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_product_rating":{"description":"Source-documented tiktok_seller_product_product_rating; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_review_count":{"description":"Source-documented tiktok_seller_product_review_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_commission_rate":{"description":"Source-documented tiktok_seller_product_commission_rate; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_total_related_creator_count":{"description":"Source-documented tiktok_seller_product_total_related_creator_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_total_related_video_count":{"description":"Source-documented tiktok_seller_product_total_related_video_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_floor_price":{"description":"Source-documented tiktok_seller_product_floor_price; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_ceiling_price":{"description":"Source-documented tiktok_seller_product_ceiling_price; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_product_images":{"description":"Source-documented tiktok_seller_product_product_images; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_product_skus":{"description":"Source-documented tiktok_seller_product_product_skus; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_product_product_sku_props":{"description":"Source-documented tiktok_seller_product_product_sku_props; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Shop Related Products. Known row fields: id, tiktok_seller_product_product_id, tiktok_seller_product_product_name, tiktok_seller_product_product_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"tiktok_seller_product_product_id":null,"tiktok_seller_product_product_name":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-shop-related-products","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_shop_related_products","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-related-creators/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Shop Related Creators","description":"Provider business records for TikTok Shop Related Creators. Known row fields: id, tiktok_seller_detail_creator_user_id, tiktok_seller_detail_creator_unique_id, tiktok_seller_detail_creator_nickname, tiktok_seller_detail_creator_follower_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokShopRelatedCreators","externalDocs":{"description":"Nexscope TikTok Shop Related Creators documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-shop-related-creators"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":10,"example":5},"id":{"type":"string","description":"Shop ID, preserved as a string.","minLength":1,"example":"7495205878591949358"}},"required":["country","id"]},"example":{"country":"us","id":"7495205878591949358","page":1,"pageSize":5}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_user_id":{"description":"Source-documented tiktok_seller_detail_creator_user_id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_seller_id":{"description":"Source-documented tiktok_seller_detail_creator_seller_id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_unique_id":{"description":"Source-documented tiktok_seller_detail_creator_unique_id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_nickname":{"description":"Source-documented tiktok_seller_detail_creator_nickname; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_country_code":{"description":"Source-documented tiktok_seller_detail_creator_country_code; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_account_type":{"description":"Source-documented tiktok_seller_detail_creator_account_type; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_category_label":{"description":"Source-documented tiktok_seller_detail_creator_category_label; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_user_avatar":{"description":"Source-documented tiktok_seller_detail_creator_user_avatar; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_youtube_channel_id":{"description":"Source-documented tiktok_seller_detail_creator_youtube_channel_id; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_follower_count":{"description":"Source-documented tiktok_seller_detail_creator_follower_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_total_favorited":{"description":"Source-documented tiktok_seller_detail_creator_total_favorited; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_video_count":{"description":"Source-documented tiktok_seller_detail_creator_video_count; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_related_total_video":{"description":"Source-documented tiktok_seller_detail_creator_related_total_video; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_author_avg_like_cnt":{"description":"Source-documented tiktok_seller_detail_creator_author_avg_like_cnt; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_author_avg_play_cnt":{"description":"Source-documented tiktok_seller_detail_creator_author_avg_play_cnt; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_author_total_play_cnt":{"description":"Source-documented tiktok_seller_detail_creator_author_total_play_cnt; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_author_avg_engagement_rate":{"description":"Source-documented tiktok_seller_detail_creator_author_avg_engagement_rate; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_by_live":{"description":"Source-documented tiktok_seller_detail_creator_by_live; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_by_shop":{"description":"Source-documented tiktok_seller_detail_creator_by_shop; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_by_video":{"description":"Source-documented tiktok_seller_detail_creator_by_video; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_video_7d_gmv":{"description":"Source-documented tiktok_seller_detail_creator_video_7d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_video_30d_gmv":{"description":"Source-documented tiktok_seller_detail_creator_video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_live_7d_gmv":{"description":"Source-documented tiktok_seller_detail_live_7d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_live_30d_gmv":{"description":"Source-documented tiktok_seller_detail_creator_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_total_video_live_7d_gmv":{"description":"Source-documented tiktok_seller_detail_creator_total_video_live_7d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_total_video_live_30d_gmv":{"description":"Source-documented tiktok_seller_detail_creator_total_video_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"tiktok_seller_detail_creator_bio_email":{"description":"Source-documented tiktok_seller_detail_creator_bio_email; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Shop Related Creators. Known row fields: id, tiktok_seller_detail_creator_user_id, tiktok_seller_detail_creator_unique_id, tiktok_seller_detail_creator_nickname, tiktok_seller_detail_creator_follower_count. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"tiktok_seller_detail_creator_user_id":null,"tiktok_seller_detail_creator_seller_id":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-shop-related-creators","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_shop_related_creators","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-product-related-videos/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Product Related Videos","description":"Provider business records for TikTok Product Related Videos. Video identity, author, timing, engagement and sales fields are documented. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokProductRelatedVideos","externalDocs":{"description":"Nexscope TikTok Product Related Videos documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-related-videos"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":10,"example":5},"id":{"type":"string","description":"Product ID, preserved as a string.","minLength":1,"example":"1732052189676081387"}},"required":["country","id"]},"example":{"country":"us","id":"1732052189676081387","page":1,"pageSize":5}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"video_id":{"description":"Source-documented video_id; may be absent or null. Preserve the provider value and original monetary units."},"video_desc":{"description":"Source-documented video_desc; may be absent or null. Preserve the provider value and original monetary units."},"share_url":{"description":"Source-documented share_url; may be absent or null. Preserve the provider value and original monetary units."},"video_cover":{"description":"Source-documented video_cover; may be absent or null. Preserve the provider value and original monetary units."},"author_id":{"description":"Source-documented author_id; may be absent or null. Preserve the provider value and original monetary units."},"author_unique_id":{"description":"Source-documented author_unique_id; may be absent or null. Preserve the provider value and original monetary units."},"author_nickname":{"description":"Source-documented author_nickname; may be absent or null. Preserve the provider value and original monetary units."},"user_avatar":{"description":"Source-documented user_avatar; may be absent or null. Preserve the provider value and original monetary units."},"video_launch_time":{"description":"Source-documented video_launch_time; may be absent or null. Preserve the provider value and original monetary units."},"video_duration":{"description":"Source-documented video_duration; may be absent or null. Preserve the provider value and original monetary units."},"video_play_count":{"description":"Source-documented video_play_count; may be absent or null. Preserve the provider value and original monetary units."},"video_like_count":{"description":"Source-documented video_like_count; may be absent or null. Preserve the provider value and original monetary units."},"video_comment_count":{"description":"Source-documented video_comment_count; may be absent or null. Preserve the provider value and original monetary units."},"video_share_count":{"description":"Source-documented video_share_count; may be absent or null. Preserve the provider value and original monetary units."},"video_collect_count":{"description":"Source-documented video_collect_count; may be absent or null. Preserve the provider value and original monetary units."},"video_engagement_rate":{"description":"Source-documented video_engagement_rate; may be absent or null. Preserve the provider value and original monetary units."},"video_30d_gmv":{"description":"Source-documented video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"video_30d_sold_count":{"description":"Source-documented video_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"is_ad":{"description":"Source-documented is_ad; may be absent or null. Preserve the provider value and original monetary units."},"is_aigc_video":{"description":"Source-documented is_aigc_video; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Product Related Videos. Known row fields: video_id. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"video_id":null,"video_desc":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-product-related-videos","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_product_related_videos","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-product-reviews/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Product Reviews","description":"Provider business records for TikTok Product Reviews. Review identity, text, rating, author, media and SKU fields are documented. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokProductReviews","externalDocs":{"description":"Nexscope TikTok Product Reviews documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-reviews"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":10,"example":5},"id":{"type":"string","description":"Product ID, preserved as a string.","minLength":1,"example":"1732052189676081387"}},"required":["country","id"]},"example":{"country":"us","id":"1732052189676081387","page":1,"pageSize":5}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"review_id":{"description":"Source-documented review_id; may be absent or null. Preserve the provider value and original monetary units."},"review_text":{"description":"Source-documented review_text; may be absent or null. Preserve the provider value and original monetary units."},"rating":{"description":"Source-documented rating; may be absent or null. Preserve the provider value and original monetary units."},"create_time":{"description":"Source-documented create_time; may be absent or null. Preserve the provider value and original monetary units."},"publish_time":{"description":"Source-documented publish_time; may be absent or null. Preserve the provider value and original monetary units."},"user_id":{"description":"Source-documented user_id; may be absent or null. Preserve the provider value and original monetary units."},"user_unique_id":{"description":"Source-documented user_unique_id; may be absent or null. Preserve the provider value and original monetary units."},"user_nickname":{"description":"Source-documented user_nickname; may be absent or null. Preserve the provider value and original monetary units."},"user_avatar":{"description":"Source-documented user_avatar; may be absent or null. Preserve the provider value and original monetary units."},"review_images":{"description":"Source-documented review_images; may be absent or null. Preserve the provider value and original monetary units."},"review_videos":{"description":"Source-documented review_videos; may be absent or null. Preserve the provider value and original monetary units."},"sku_info":{"description":"Source-documented sku_info; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Product Reviews. Known row fields: review_id. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"review_id":null,"review_text":null,"rating":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-product-reviews","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_product_reviews","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-product-related-lives/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Product Related Lives","description":"Provider business records for TikTok Product Related Lives. Live identity, host, timing, audience and sales fields are documented. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokProductRelatedLives","externalDocs":{"description":"Nexscope TikTok Product Related Lives documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-related-lives"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":10,"example":5},"id":{"type":"string","description":"Product ID, preserved as a string.","minLength":1,"example":"1732052189676081387"}},"required":["country","id"]},"example":{"country":"us","id":"1732052189676081387","page":1,"pageSize":5}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"room_id":{"description":"Source-documented room_id; may be absent or null. Preserve the provider value and original monetary units."},"title":{"description":"Source-documented title; may be absent or null. Preserve the provider value and original monetary units."},"room_link":{"description":"Source-documented room_link; may be absent or null. Preserve the provider value and original monetary units."},"user_id":{"description":"Source-documented user_id; may be absent or null. Preserve the provider value and original monetary units."},"user_unique_id":{"description":"Source-documented user_unique_id; may be absent or null. Preserve the provider value and original monetary units."},"user_nickname":{"description":"Source-documented user_nickname; may be absent or null. Preserve the provider value and original monetary units."},"country_code":{"description":"Source-documented country_code; may be absent or null. Preserve the provider value and original monetary units."},"start_time":{"description":"Source-documented start_time; may be absent or null. Preserve the provider value and original monetary units."},"end_time":{"description":"Source-documented end_time; may be absent or null. Preserve the provider value and original monetary units."},"gmv":{"description":"Source-documented gmv; may be absent or null. Preserve the provider value and original monetary units."},"gpm":{"description":"Source-documented gpm; may be absent or null. Preserve the provider value and original monetary units."},"opm":{"description":"Source-documented opm; may be absent or null. Preserve the provider value and original monetary units."},"total_sold_count":{"description":"Source-documented total_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"product_count":{"description":"Source-documented product_count; may be absent or null. Preserve the provider value and original monetary units."},"total_user":{"description":"Source-documented total_user; may be absent or null. Preserve the provider value and original monetary units."},"max_user_count":{"description":"Source-documented max_user_count; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Product Related Lives. Known row fields: room_id. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"room_id":null,"title":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-product-related-lives","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_product_related_lives","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-product-related-creators/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Product Related Creators","description":"Provider business records for TikTok Product Related Creators. Creator identity, audience, engagement, sales and contact fields are documented. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokProductRelatedCreators","externalDocs":{"description":"Nexscope TikTok Product Related Creators documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-related-creators"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":10,"example":5},"id":{"type":"string","description":"Product ID, preserved as a string.","minLength":1,"example":"1732052189676081387"}},"required":["country","id"]},"example":{"country":"us","id":"1732052189676081387","page":1,"pageSize":5}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"user_id":{"description":"Source-documented user_id; may be absent or null. Preserve the provider value and original monetary units."},"uid":{"description":"Source-documented uid; may be absent or null. Preserve the provider value and original monetary units."},"unique_id":{"description":"Source-documented unique_id; may be absent or null. Preserve the provider value and original monetary units."},"nickname":{"description":"Source-documented nickname; may be absent or null. Preserve the provider value and original monetary units."},"user_avatar":{"description":"Source-documented user_avatar; may be absent or null. Preserve the provider value and original monetary units."},"follower_count":{"description":"Source-documented follower_count; may be absent or null. Preserve the provider value and original monetary units."},"video_count":{"description":"Source-documented video_count; may be absent or null. Preserve the provider value and original monetary units."},"author_avg_engagement_rate":{"description":"Source-documented author_avg_engagement_rate; may be absent or null. Preserve the provider value and original monetary units."},"video_avg_play_count":{"description":"Source-documented video_avg_play_count; may be absent or null. Preserve the provider value and original monetary units."},"video_avg_like_count":{"description":"Source-documented video_avg_like_count; may be absent or null. Preserve the provider value and original monetary units."},"video_30d_gmv":{"description":"Source-documented video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"video_30d_sold_count":{"description":"Source-documented video_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"live_30d_gmv":{"description":"Source-documented live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"live_30d_sold_count":{"description":"Source-documented live_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"total_video_live_30d_gmv":{"description":"Source-documented total_video_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"total_video_live_30d_sold_count":{"description":"Source-documented total_video_live_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"country_code":{"description":"Source-documented country_code; may be absent or null. Preserve the provider value and original monetary units."},"category_label":{"description":"Source-documented category_label; may be absent or null. Preserve the provider value and original monetary units."},"bio_email":{"description":"Source-documented bio_email; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Product Related Creators. Known row fields: user_id, uid, unique_id, nickname. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"user_id":null,"uid":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-product-related-creators","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_product_related_creators","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-creator-detail/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Creator Detail","description":"Provider business records for TikTok Creator Detail. Base creator fields and optional core, channel, and portrait sections are documented. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokCreatorDetail","externalDocs":{"description":"Nexscope TikTok Creator Detail documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-creator-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"id":{"type":"string","description":"Creator ID, preserved as a string.","minLength":1,"example":"7302162228386776110"},"include":{"type":"string","description":"Comma-separated optional detail sections: core, channel, portrait.","pattern":"^(core|channel|portrait)(,(core|channel|portrait))*$","example":"core,channel,portrait"}},"required":["country","id"]},"example":{"country":"us","id":"7302162228386776110","include":"core,channel,portrait"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"ins_id":{"description":"Source-documented ins_id; may be absent or null. Preserve the provider value and original monetary units."},"nickname":{"description":"Source-documented nickname; may be absent or null. Preserve the provider value and original monetary units."},"unique_id":{"description":"Source-documented unique_id; may be absent or null. Preserve the provider value and original monetary units."},"signature":{"description":"Source-documented signature; may be absent or null. Preserve the provider value and original monetary units."},"user_avatar":{"description":"Source-documented user_avatar; may be absent or null. Preserve the provider value and original monetary units."},"bio_url":{"description":"Source-documented bio_url; may be absent or null. Preserve the provider value and original monetary units."},"category_label":{"description":"Source-documented category_label; may be absent or null. Preserve the provider value and original monetary units."},"product_category_label_list":{"description":"Source-documented product_category_label_list; may be absent or null. Preserve the provider value and original monetary units."},"enterprise_verify_reason":{"description":"Source-documented enterprise_verify_reason; may be absent or null. Preserve the provider value and original monetary units."},"partnered_brand":{"description":"Source-documented partnered_brand; may be absent or null. Preserve the provider value and original monetary units."},"has_live_product":{"description":"Source-documented has_live_product; may be absent or null. Preserve the provider value and original monetary units."},"has_shop_product":{"description":"Source-documented has_shop_product; may be absent or null. Preserve the provider value and original monetary units."},"has_video_product":{"description":"Source-documented has_video_product; may be absent or null. Preserve the provider value and original monetary units."},"bio_email":{"description":"Source-documented bio_email; may be absent or null. Preserve the provider value and original monetary units."},"facebook_url":{"description":"Source-documented facebook_url; may be absent or null. Preserve the provider value and original monetary units."},"youtube_channel_id":{"description":"Source-documented youtube_channel_id; may be absent or null. Preserve the provider value and original monetary units."},"last_update_time":{"description":"Source-documented last_update_time; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Creator Detail. Base creator fields and optional core, channel, and portrait sections are documented. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]},"channel":{"type":["object","null"],"properties":{"total_count":{"type":["integer","null"]},"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"channel_country_code":{"description":"Source-documented channel_country_code; may be absent or null. Preserve the provider value and original monetary units."},"channel_ec_video_30d_avg_engagement_rate":{"description":"Source-documented channel_ec_video_30d_avg_engagement_rate; may be absent or null. Preserve the provider value and original monetary units."},"channel_ec_video_30d_avg_play_count":{"description":"Source-documented channel_ec_video_30d_avg_play_count; may be absent or null. Preserve the provider value and original monetary units."},"channel_live_30d_gmv":{"description":"Source-documented channel_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"channel_live_30d_gpm":{"description":"Source-documented channel_live_30d_gpm; may be absent or null. Preserve the provider value and original monetary units."},"channel_total_video_live_30d_gmv":{"description":"Source-documented channel_total_video_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"channel_uid":{"description":"Source-documented channel_uid; may be absent or null. Preserve the provider value and original monetary units."},"channel_video_30d_gmv":{"description":"Source-documented channel_video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"channel_video_30d_gpm":{"description":"Source-documented channel_video_30d_gpm; may be absent or null. Preserve the provider value and original monetary units."},"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Optional channel detail records requested through include; preserved separately from basic items. Known fields are taken verbatim from the source reference.","type":["array","null"]},{"type":"null"}]}},"additionalProperties":true},"core":{"type":["object","null"],"properties":{"total_count":{"type":["integer","null"]},"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"core_author_avg_engagement_rate":{"description":"Source-documented core_author_avg_engagement_rate; may be absent or null. Preserve the provider value and original monetary units."},"core_follower_count":{"description":"Source-documented core_follower_count; may be absent or null. Preserve the provider value and original monetary units."},"core_product_count":{"description":"Source-documented core_product_count; may be absent or null. Preserve the provider value and original monetary units."},"core_total_favorited":{"description":"Source-documented core_total_favorited; may be absent or null. Preserve the provider value and original monetary units."},"core_uid":{"description":"Source-documented core_uid; may be absent or null. Preserve the provider value and original monetary units."},"core_video_total_like_count_to_follower_count":{"description":"Source-documented core_video_total_like_count_to_follower_count; may be absent or null. Preserve the provider value and original monetary units."},"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"tioktok_creator_detail_core_ec_video_count":{"description":"Source-documented tioktok_creator_detail_core_ec_video_count; may be absent or null. Preserve the provider value and original monetary units."},"tioktok_creator_detail_core_ecom_video_avg_play_count":{"description":"Source-documented tioktok_creator_detail_core_ecom_video_avg_play_count; may be absent or null. Preserve the provider value and original monetary units."},"tioktok_creator_detail_core_med_commission_rate":{"description":"Source-documented tioktok_creator_detail_core_med_commission_rate; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Optional core detail records requested through include; preserved separately from basic items. Known fields are taken verbatim from the source reference.","type":["array","null"]},{"type":"null"}]}},"additionalProperties":true},"portrait":{"type":["object","null"],"properties":{"total_count":{"type":["integer","null"]},"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"portrait_age_distribution":{"description":"Source-documented portrait_age_distribution; may be absent or null. Preserve the provider value and original monetary units."},"portrait_follower_count":{"description":"Source-documented portrait_follower_count; may be absent or null. Preserve the provider value and original monetary units."},"portrait_gender_distribution":{"description":"Source-documented portrait_gender_distribution; may be absent or null. Preserve the provider value and original monetary units."},"portrait_region_distribution":{"description":"Source-documented portrait_region_distribution; may be absent or null. Preserve the provider value and original monetary units."},"portrait_uid":{"description":"Source-documented portrait_uid; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Optional portrait detail records requested through include; preserved separately from basic items. Known fields are taken verbatim from the source reference.","type":["array","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"ins_id":null,"nickname":null}],"channel":{"items":[{"channel_country_code":null,"channel_ec_video_30d_avg_engagement_rate":null,"channel_ec_video_30d_avg_play_count":null}]},"core":{"items":[{"core_author_avg_engagement_rate":null,"core_follower_count":null,"core_product_count":null}]},"portrait":{"items":[{"id":null,"portrait_age_distribution":null,"portrait_follower_count":null}]}}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-creator-detail","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_creator_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-shop-detail/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Shop Detail","description":"Provider business records for TikTok Shop Detail. Known row fields: id, seller_id, shop_name, region, shop_rating, shop_total_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokShopDetail","externalDocs":{"description":"Nexscope TikTok Shop Detail documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-shop-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"id":{"type":"string","description":"Shop ID, preserved as a string.","minLength":1,"example":"7495205878591949358"},"include":{"type":"string","description":"Comma-separated optional detail sections: core, channel.","pattern":"^(core|channel)(,(core|channel))*$","example":"core,channel"}},"required":["country","id"]},"example":{"country":"us","id":"7495205878591949358","include":"core,channel"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"seller_id":{"description":"Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units."},"shop_name":{"description":"Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."},"region":{"description":"Source-documented region; may be absent or null. Preserve the provider value and original monetary units."},"shop_main_category":{"description":"Source-documented shop_main_category; may be absent or null. Preserve the provider value and original monetary units."},"shop_rating":{"description":"Source-documented shop_rating; may be absent or null. Preserve the provider value and original monetary units."},"shop_total_gmv":{"description":"Source-documented shop_total_gmv; may be absent or null. Preserve the provider value and original monetary units."},"business_info":{"description":"Source-documented business_info; may be absent or null. Preserve the provider value and original monetary units."},"seller_avatar":{"description":"Source-documented seller_avatar; may be absent or null. Preserve the provider value and original monetary units."},"create_time":{"description":"Source-documented create_time; may be absent or null. Preserve the provider value and original monetary units."},"last_update_time":{"description":"Source-documented last_update_time; may be absent or null. Preserve the provider value and original monetary units."},"creator_user_id":{"description":"Source-documented creator_user_id; may be absent or null. Preserve the provider value and original monetary units."},"creator_user_name":{"description":"Source-documented creator_user_name; may be absent or null. Preserve the provider value and original monetary units."},"creator_nickname":{"description":"Source-documented creator_nickname; may be absent or null. Preserve the provider value and original monetary units."},"creator_role":{"description":"Source-documented creator_role; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Shop Detail. Known row fields: id, seller_id, shop_name, region, shop_rating, shop_total_gmv. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]},"channel":{"type":["object","null"],"properties":{"total_count":{"type":["integer","null"]},"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"channel_seller_id":{"description":"Source-documented channel_seller_id; may be absent or null. Preserve the provider value and original monetary units."},"channel_seller_sold_count_for_last_30_days":{"description":"Source-documented channel_seller_sold_count_for_last_30_days; may be absent or null. Preserve the provider value and original monetary units."},"channel_seller_gmv_for_last_30_days":{"description":"Source-documented channel_seller_gmv_for_last_30_days; may be absent or null. Preserve the provider value and original monetary units."},"channel_video_30d_sold_count":{"description":"Source-documented channel_video_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"channel_video_30d_gmv":{"description":"Source-documented channel_video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"channel_live_30d_sold_count":{"description":"Source-documented channel_live_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"channel_live_30d_gmv":{"description":"Source-documented channel_live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"channel_product_card_30d_sold_count":{"description":"Source-documented channel_product_card_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"channel_product_card_30d_gmv":{"description":"Source-documented channel_product_card_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"channel_personal_creator_30d_sold_count":{"description":"Source-documented channel_personal_creator_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"channel_personal_creator_30d_gmv":{"description":"Source-documented channel_personal_creator_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"channel_seller_creator_30d_sold_count":{"description":"Source-documented channel_seller_creator_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"channel_seller_creator_30d_gmv":{"description":"Source-documented channel_seller_creator_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Optional channel detail records requested through include; preserved separately from basic items. Known fields are taken verbatim from the source reference.","type":["array","null"]},{"type":"null"}]}},"additionalProperties":true},"core":{"type":["object","null"],"properties":{"total_count":{"type":["integer","null"]},"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"core_seller_id":{"description":"Source-documented core_seller_id; may be absent or null. Preserve the provider value and original monetary units."},"core_region":{"description":"Source-documented core_region; may be absent or null. Preserve the provider value and original monetary units."},"core_seller_shop_product_count":{"description":"Source-documented core_seller_shop_product_count; may be absent or null. Preserve the provider value and original monetary units."},"core_seller_shop_total_product_count":{"description":"Source-documented core_seller_shop_total_product_count; may be absent or null. Preserve the provider value and original monetary units."},"core_shop_total_sold_count":{"description":"Source-documented core_shop_total_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"core_seller_shop_total_gmv":{"description":"Source-documented core_seller_shop_total_gmv; may be absent or null. Preserve the provider value and original monetary units."},"core_seller_sold_count_for_last_30_days":{"description":"Source-documented core_seller_sold_count_for_last_30_days; may be absent or null. Preserve the provider value and original monetary units."},"core_seller_gmv_for_last_30_days":{"description":"Source-documented core_seller_gmv_for_last_30_days; may be absent or null. Preserve the provider value and original monetary units."},"core_seller_total_related_creator_count":{"description":"Source-documented core_seller_total_related_creator_count; may be absent or null. Preserve the provider value and original monetary units."},"core_seller_total_related_live_creator_count":{"description":"Source-documented core_seller_total_related_live_creator_count; may be absent or null. Preserve the provider value and original monetary units."},"core_seller_total_related_video_creator_count":{"description":"Source-documented core_seller_total_related_video_creator_count; may be absent or null. Preserve the provider value and original monetary units."},"core_seller_total_related_shop_creator_count":{"description":"Source-documented core_seller_total_related_shop_creator_count; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Optional core detail records requested through include; preserved separately from basic items. Known fields are taken verbatim from the source reference.","type":["array","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"seller_id":null,"shop_name":null}],"channel":{"items":[{"id":null,"channel_seller_id":null,"channel_seller_sold_count_for_last_30_days":null}]},"core":{"items":[{"id":null,"core_seller_id":null,"core_region":null}]}}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-shop-detail","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_shop_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-product-detail/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Product Detail","description":"Provider business records for TikTok Product Detail. Base product, optional core performance, and channel attribution fields are documented. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokProductDetail","externalDocs":{"description":"Nexscope TikTok Product Detail documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"id":{"type":"string","description":"Product ID, preserved as a string.","minLength":1,"example":"1732052189676081387"},"include":{"type":"string","description":"Comma-separated optional detail sections: core, channel.","pattern":"^(core|channel)(,(core|channel))*$","example":"core,channel"}},"required":["country","id"]},"example":{"country":"us","id":"1732052189676081387","include":"core,channel"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"product_id":{"description":"Source-documented product_id; may be absent or null. Preserve the provider value and original monetary units."},"product_name":{"description":"Source-documented product_name; may be absent or null. Preserve the provider value and original monetary units."},"product_images":{"description":"Source-documented product_images; may be absent or null. Preserve the provider value and original monetary units."},"floor_price":{"description":"Source-documented floor_price; may be absent or null. Preserve the provider value and original monetary units."},"ceiling_price":{"description":"Source-documented ceiling_price; may be absent or null. Preserve the provider value and original monetary units."},"product_rating":{"description":"Source-documented product_rating; may be absent or null. Preserve the provider value and original monetary units."},"review_count":{"description":"Source-documented review_count; may be absent or null. Preserve the provider value and original monetary units."},"product_sold_count":{"description":"Source-documented product_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"product_gmv":{"description":"Source-documented product_gmv; may be absent or null. Preserve the provider value and original monetary units."},"product_sku_props":{"description":"Source-documented product_sku_props; may be absent or null. Preserve the provider value and original monetary units."},"product_skus":{"description":"Source-documented product_skus; may be absent or null. Preserve the provider value and original monetary units."},"product_l1_category":{"description":"Source-documented product_l1_category; may be absent or null. Preserve the provider value and original monetary units."},"product_l2_category":{"description":"Source-documented product_l2_category; may be absent or null. Preserve the provider value and original monetary units."},"product_l3_category":{"description":"Source-documented product_l3_category; may be absent or null. Preserve the provider value and original monetary units."},"shop_name":{"description":"Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."},"seller_id":{"description":"Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units."},"region":{"description":"Source-documented region; may be absent or null. Preserve the provider value and original monetary units."},"product_status":{"description":"Source-documented product_status; may be absent or null. Preserve the provider value and original monetary units."},"seller_type":{"description":"Source-documented seller_type; may be absent or null. Preserve the provider value and original monetary units."},"commission_rate":{"description":"Source-documented commission_rate; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Product Detail. Known row fields: id, product_id, product_name, product_images. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]},"channel":{"type":["object","null"],"properties":{"total_count":{"type":["integer","null"]},"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"video_30d_gmv":{"description":"Source-documented video_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"video_30d_sold_count":{"description":"Source-documented video_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"live_30d_gmv":{"description":"Source-documented live_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"live_30d_sold_count":{"description":"Source-documented live_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"product_card_30d_gmv":{"description":"Source-documented product_card_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"product_card_30d_sold_count":{"description":"Source-documented product_card_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"personal_creator_30d_gmv":{"description":"Source-documented personal_creator_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"personal_creator_30d_sold_count":{"description":"Source-documented personal_creator_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"seller_creator_30d_gmv":{"description":"Source-documented seller_creator_30d_gmv; may be absent or null. Preserve the provider value and original monetary units."},"seller_creator_30d_sold_count":{"description":"Source-documented seller_creator_30d_sold_count; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Optional channel detail records requested through include; preserved separately from basic items. Known fields are taken verbatim from the source reference.","type":["array","null"]},{"type":"null"}]}},"additionalProperties":true},"core":{"type":["object","null"],"properties":{"total_count":{"type":["integer","null"]},"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"product_gmv":{"description":"Source-documented product_gmv; may be absent or null. Preserve the provider value and original monetary units."},"product_sold_count":{"description":"Source-documented product_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"product_gmv_30d":{"description":"Source-documented product_gmv_30d; may be absent or null. Preserve the provider value and original monetary units."},"product_sold_count_30d":{"description":"Source-documented product_sold_count_30d; may be absent or null. Preserve the provider value and original monetary units."},"product_gmv_7d":{"description":"Source-documented product_gmv_7d; may be absent or null. Preserve the provider value and original monetary units."},"product_sold_count_7d":{"description":"Source-documented product_sold_count_7d; may be absent or null. Preserve the provider value and original monetary units."},"product_ad_gmv":{"description":"Source-documented product_ad_gmv; may be absent or null. Preserve the provider value and original monetary units."},"product_ad_sold_count":{"description":"Source-documented product_ad_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"product_video_gmv":{"description":"Source-documented product_video_gmv; may be absent or null. Preserve the provider value and original monetary units."},"product_video_sold_count":{"description":"Source-documented product_video_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"product_live_gmv":{"description":"Source-documented product_live_gmv; may be absent or null. Preserve the provider value and original monetary units."},"product_live_sold_count":{"description":"Source-documented product_live_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"related_creator_count":{"description":"Source-documented related_creator_count; may be absent or null. Preserve the provider value and original monetary units."},"related_live_count":{"description":"Source-documented related_live_count; may be absent or null. Preserve the provider value and original monetary units."},"related_video_count":{"description":"Source-documented related_video_count; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Optional core detail records requested through include; preserved separately from basic items. Known fields are taken verbatim from the source reference.","type":["array","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"product_id":null,"product_name":null}],"channel":{"items":[{"id":null,"video_30d_gmv":null,"video_30d_sold_count":null}]},"core":{"items":[{"id":null,"product_gmv":null,"product_sold_count":null}]}}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-product-detail","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_product_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/chuhaijiang-tiktok-product-search/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Product Market Search","description":"Provider business records for TikTok Product Market Search. Product identity, pricing, sales, seller, category, and SKU fields are documented. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","operationId":"runChuhaijiangTiktokProductSearch","externalDocs":{"description":"Nexscope TikTok Product Search documentation","url":"https://www.nexscope.ai/api-docs/chuhaijiang-tiktok-product-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","description":"Lowercase TikTok market code.","enum":["br","de","es","fr","gb","id","it","jp","mx","my","ph","sg","th","us","vn"],"example":"us"},"page":{"type":"integer","description":"Page number, starting at 1.","minimum":1,"example":1},"pageSize":{"type":"integer","description":"Maximum records per page.","minimum":1,"maximum":10,"example":5},"keyword":{"type":"string","description":"Product search keyword.","example":"beauty"},"category":{"type":"string","description":"Product category ID."},"sellerType":{"type":"string","description":"Seller type: 1 overseas non-brand, 2 local, 3 brand, 4 non-brand.","enum":["1","2","3","4"],"example":"2"},"freeShipping":{"type":"boolean","description":"Filter by free shipping availability.","example":true},"sort":{"type":"string","description":"Provider sort field and direction (field:asc or field:desc).","default":"gmv_7d:desc","pattern":"^(daily_sold|gmv_30d|gmv_7d|price|rating|sold_30d|sold_7d):(asc|desc)$","example":"gmv_7d:desc"},"minPrice":{"type":"number","description":"Minimum price in USD."},"maxPrice":{"type":"number","description":"Maximum price in USD."},"minRating":{"type":"number","description":"Minimum product rating.","minimum":0,"maximum":5},"maxRating":{"type":"number","description":"Maximum product rating.","minimum":0,"maximum":5},"minSold7d":{"type":"number","description":"Minimum 7-day sales."},"maxSold7d":{"type":"number","description":"Maximum 7-day sales."},"minSold30d":{"type":"number","description":"Minimum 30-day sales."},"maxSold30d":{"type":"number","description":"Maximum 30-day sales."}},"required":["country"]},"example":{"country":"us","keyword":"beauty","minRating":4,"freeShipping":true,"pageSize":5}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"request_id":{"anyOf":[{"type":["string","null"]},{"type":"null"}]},"data":{"type":["object","null"],"properties":{"items":{"anyOf":[{"items":{"type":["object","null"],"properties":{"id":{"description":"Source-documented id; may be absent or null. Preserve the provider value and original monetary units."},"product_id":{"description":"Source-documented product_id; may be absent or null. Preserve the provider value and original monetary units."},"product_name":{"description":"Source-documented product_name; may be absent or null. Preserve the provider value and original monetary units."},"product_images":{"description":"Source-documented product_images; may be absent or null. Preserve the provider value and original monetary units."},"floor_price":{"description":"Source-documented floor_price; may be absent or null. Preserve the provider value and original monetary units."},"ceiling_price":{"description":"Source-documented ceiling_price; may be absent or null. Preserve the provider value and original monetary units."},"product_rating":{"description":"Source-documented product_rating; may be absent or null. Preserve the provider value and original monetary units."},"review_count":{"description":"Source-documented review_count; may be absent or null. Preserve the provider value and original monetary units."},"product_sold_count":{"description":"Source-documented product_sold_count; may be absent or null. Preserve the provider value and original monetary units."},"product_sold_count_for_last_7_days":{"description":"Source-documented product_sold_count_for_last_7_days; may be absent or null. Preserve the provider value and original monetary units."},"product_sold_count_for_last_30_days":{"description":"Source-documented product_sold_count_for_last_30_days; may be absent or null. Preserve the provider value and original monetary units."},"product_gmv":{"description":"Source-documented product_gmv; may be absent or null. Preserve the provider value and original monetary units."},"product_gmv_for_last_7_days":{"description":"Source-documented product_gmv_for_last_7_days; may be absent or null. Preserve the provider value and original monetary units."},"product_gmv_for_last_30_days":{"description":"Source-documented product_gmv_for_last_30_days; may be absent or null. Preserve the provider value and original monetary units."},"country_code":{"description":"Source-documented country_code; may be absent or null. Preserve the provider value and original monetary units."},"region":{"description":"Source-documented region; may be absent or null. Preserve the provider value and original monetary units."},"seller_id":{"description":"Source-documented seller_id; may be absent or null. Preserve the provider value and original monetary units."},"shop_name":{"description":"Source-documented shop_name; may be absent or null. Preserve the provider value and original monetary units."},"product_status":{"description":"Source-documented product_status; may be absent or null. Preserve the provider value and original monetary units."},"seller_type":{"description":"Source-documented seller_type; may be absent or null. Preserve the provider value and original monetary units."},"product_l1_category":{"description":"Source-documented product_l1_category; may be absent or null. Preserve the provider value and original monetary units."},"product_l2_category":{"description":"Source-documented product_l2_category; may be absent or null. Preserve the provider value and original monetary units."},"product_l3_category":{"description":"Source-documented product_l3_category; may be absent or null. Preserve the provider value and original monetary units."},"commission_rate":{"description":"Source-documented commission_rate; may be absent or null. Preserve the provider value and original monetary units."},"free_shipping":{"description":"Source-documented free_shipping; may be absent or null. Preserve the provider value and original monetary units."},"product_sku_props":{"description":"Source-documented product_sku_props; may be absent or null. Preserve the provider value and original monetary units."},"product_skus":{"description":"Source-documented product_skus; may be absent or null. Preserve the provider value and original monetary units."}},"additionalProperties":true},"description":"Provider business records for TikTok Product Market Search. Known row fields: id, product_name, product_images, floor_price, ceiling_price, product_rating, product_sold_count, product_gmv, seller_id, shop_name. Missing and null fields remain unchanged; monetary values retain their original unit and runtime type.","type":["array","null"]},{"type":"null"}]},"total_count":{"anyOf":[{"description":"Total matching records.","type":["integer","null"]},{"type":"null"}]}},"additionalProperties":true}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{"items":[{"id":null,"product_id":null,"product_name":null}]}},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"chuhaijiang-tiktok-product-search","x-nexscope-mcp-tool-name":"nexscope_chuhaijiang_tiktok_product_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/geekbi-temu-goods-image-search/run":{"post":{"tags":["Temu Marketplace Intelligence"],"summary":"Nexscope Temu Image Search","description":"Execute the selected image search operation and preserve provider business fields and extensions.","operationId":"runGeekbiTemuGoodsImageSearch","externalDocs":{"description":"Nexscope Temu Image Search documentation","url":"https://www.nexscope.ai/api-docs/geekbi-temu-goods-image-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"imageUrl":{"type":"string","description":"Provider OSS temporary image URL, obtained through presignedPut and a successful PUT upload with the signature query removed. Replace the example.invalid placeholder before calling; external URLs are rejected upstream. Actual image must be at most 10 MB and JPEG, PNG, GIF, WebP or BMP.","minLength":1,"maxLength":2048,"format":"uri"},"contentType":{"type":"string","description":"Must match OSS response and actual image bytes; omitted means server detection.","maxLength":100,"enum":["image/jpeg","image/png","image/gif","image/webp","image/bmp"]}},"required":["imageUrl"]},"example":{"imageUrl":"https://example.invalid/replace-with-provider-oss-image","contentType":"image/jpeg"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"columns":{"anyOf":[{"type":["array","null"],"description":"Render column definitions; business records are separate.","items":{}},{"type":"null"}]},"title":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: title."},{"type":"null"}]},"type":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: type."},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: sourceTool."},{"type":"null"}]},"sourceType":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: sourceType."},{"type":"null"}]},"items":{"anyOf":[{"type":["array","null"],"description":"Returned records, including valid empty results; preserve duplicate records and unknown fields.","items":{"type":"object","properties":{"isAd":{"type":["boolean","null"],"description":"Provider product flag: isAd."},"isCustom":{"type":["boolean","null"],"description":"Provider product flag: isCustom."},"isPresale":{"type":["boolean","null"],"description":"Provider product flag: isPresale."},"goodsId":{"type":["string","null"],"description":"Provider goodsId; preserve identifier and timestamp strings."},"mallId":{"type":["string","null"],"description":"Provider mallId; preserve identifier and timestamp strings."},"thumbnail":{"type":["string","null"],"description":"Provider thumbnail; preserve identifier and timestamp strings."},"goodsName":{"type":["string","null"],"description":"Provider goodsName; preserve identifier and timestamp strings."},"goodsNameCn":{"type":["string","null"],"description":"Provider goodsNameCn; preserve identifier and timestamp strings."},"goodsNameEn":{"type":["string","null"],"description":"Provider goodsNameEn; preserve identifier and timestamp strings."},"brand":{"type":["string","null"],"description":"Provider brand; preserve identifier and timestamp strings."},"sku":{"type":["string","null"],"description":"Provider sku; preserve identifier and timestamp strings."},"onSaleTime":{"type":["string","null"],"description":"Provider onSaleTime; preserve identifier and timestamp strings."},"mallOpenTime":{"type":["string","null"],"description":"Provider mallOpenTime; preserve identifier and timestamp strings."},"createTime":{"type":["string","null"],"description":"Provider createTime; preserve identifier and timestamp strings."},"updateTime":{"type":["string","null"],"description":"Provider updateTime; preserve identifier and timestamp strings."},"sold":{"type":["number","null"],"description":"Provider sold; monetary values use the selected site's currency unless identified as supply prices."},"quantity":{"type":["number","null"],"description":"Provider quantity; monetary values use the selected site's currency unless identified as supply prices."},"mallSold":{"type":["number","null"],"description":"Provider mallSold; monetary values use the selected site's currency unless identified as supply prices."},"sales":{"type":["number","null"],"description":"Provider sales; monetary values use the selected site's currency unless identified as supply prices."},"minPrice":{"type":["number","null"],"description":"Provider minPrice; monetary values use the selected site's currency unless identified as supply prices."},"maxPrice":{"type":["number","null"],"description":"Provider maxPrice; monetary values use the selected site's currency unless identified as supply prices."},"supplyPrice":{"type":["number","null"],"description":"Provider supplyPrice; monetary values use the selected site's currency unless identified as supply prices."},"minSupplyPrice":{"type":["number","null"],"description":"Provider minSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."},"medianSupplyPrice":{"type":["number","null"],"description":"Provider medianSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."},"maxSupplyPrice":{"type":["number","null"],"description":"Provider maxSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."},"goodsScore":{"type":["number","null"],"description":"Provider goodsScore; monetary values use the selected site's currency unless identified as supply prices."},"reviewNum":{"type":["number","null"],"description":"Provider reviewNum; monetary values use the selected site's currency unless identified as supply prices."},"hostingMode":{"type":["number","null"],"description":"Provider hostingMode; monetary values use the selected site's currency unless identified as supply prices."},"status":{"type":["number","null"],"description":"Provider status; monetary values use the selected site's currency unless identified as supply prices."},"similarNum":{"type":["number","null"],"description":"Provider similarNum; monetary values use the selected site's currency unless identified as supply prices."},"catIds":{"type":["array","null"],"description":"Associated category identifiers.","items":{}},"catItems":{"type":["array","null"],"description":"Category paths: catId, catName, catLevel, parentCatId and isLeaf.","items":{}},"daySold":{"type":["number","null"],"description":"Provider day Sold metric; sales revenue uses site currency."},"daySoldRate":{"type":["number","null"],"description":"Provider growth rate for day Sold."},"daySales":{"type":["number","null"],"description":"Provider day Sales metric; sales revenue uses site currency."},"daySalesRate":{"type":["number","null"],"description":"Provider growth rate for day Sales."},"weekSold":{"type":["number","null"],"description":"Provider week Sold metric; sales revenue uses site currency."},"weekSoldRate":{"type":["number","null"],"description":"Provider growth rate for week Sold."},"weekSales":{"type":["number","null"],"description":"Provider week Sales metric; sales revenue uses site currency."},"weekSalesRate":{"type":["number","null"],"description":"Provider growth rate for week Sales."},"monthSold":{"type":["number","null"],"description":"Provider month Sold metric; sales revenue uses site currency."},"monthSoldRate":{"type":["number","null"],"description":"Provider growth rate for month Sold."},"monthSales":{"type":["number","null"],"description":"Provider month Sales metric; sales revenue uses site currency."},"monthSalesRate":{"type":["number","null"],"description":"Provider growth rate for month Sales."}}}},{"type":"null"}]},"total":{"anyOf":[{"type":["integer","null"],"description":"Provider match count, possibly capped at 10000 for searches."},{"type":"null"}]}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"columns":[],"items":[],"total":0},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"geekbi-temu-goods-image-search","x-nexscope-mcp-tool-name":"nexscope_geekbi_temu_goods_image_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/geekbi-temu-mall-search/run":{"post":{"tags":["Temu Marketplace Intelligence"],"summary":"Nexscope Temu Shop Search","description":"Execute the selected shop search operation and preserve provider business fields and extensions.","operationId":"runGeekbiTemuMallSearch","externalDocs":{"description":"Nexscope Temu Shop Search documentation","url":"https://www.nexscope.ai/api-docs/geekbi-temu-mall-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"regionId":{"type":"integer","description":"Temu region from sites[].regionId; never siteId.","minimum":1,"default":211},"page":{"type":"integer","description":"Page number.","minimum":1,"default":1},"size":{"type":"integer","description":"Items per page; page times size must not exceed 10000.","minimum":1,"maximum":200,"default":20},"keyword":{"type":"string","description":"User keyword; preserve the supplied language.","maxLength":300},"sort":{"type":"string","description":"Confirmed provider sort field; omit when unnecessary.","maxLength":100},"order":{"type":"string","description":"Sort direction, case-insensitive.","pattern":"^([aA][sS][cC]|[dD][eE][sS][cC])$"},"catIds":{"type":"array","description":"Category identifiers obtained from category lookup.","items":{"type":"integer","minimum":0}},"hostingMode":{"type":"integer","description":"1 fully managed, 2 semi-managed.","enum":[1,2]},"mallSoldMin":{"type":"integer","description":"Lower bound for mallSold; minimum must not exceed maximum.","minimum":0},"mallSoldMax":{"type":"integer","description":"Upper bound for mallSold; minimum must not exceed maximum.","minimum":0},"reviewNumMin":{"type":"integer","description":"Lower bound for reviewNum; minimum must not exceed maximum.","minimum":0},"reviewNumMax":{"type":"integer","description":"Upper bound for reviewNum; minimum must not exceed maximum.","minimum":0},"goodsNumMin":{"type":"integer","description":"Lower bound for goodsNum; minimum must not exceed maximum.","minimum":0},"goodsNumMax":{"type":"integer","description":"Upper bound for goodsNum; minimum must not exceed maximum.","minimum":0},"followerNumMin":{"type":"integer","description":"Lower bound for followerNum; minimum must not exceed maximum.","minimum":0},"followerNumMax":{"type":"integer","description":"Upper bound for followerNum; minimum must not exceed maximum.","minimum":0},"mallSalesMin":{"type":"number","description":"Lower bound for mallSales; minimum must not exceed maximum.","minimum":0},"mallSalesMax":{"type":"number","description":"Upper bound for mallSales; minimum must not exceed maximum.","minimum":0},"avgPriceMin":{"type":"number","description":"Lower bound for avgPrice; minimum must not exceed maximum.","minimum":0},"avgPriceMax":{"type":"number","description":"Upper bound for avgPrice; minimum must not exceed maximum.","minimum":0},"mallStarMin":{"type":"number","description":"Lower bound for mallStar; minimum must not exceed maximum.","minimum":0,"maximum":5},"mallStarMax":{"type":"number","description":"Upper bound for mallStar; minimum must not exceed maximum.","minimum":0,"maximum":5},"mallOpenTimeMin":{"type":"string","description":"Earliest mallOpenTime in ISO-8601 date-time; minimum must not exceed maximum.","maxLength":40,"format":"date-time"},"mallOpenTimeMax":{"type":"string","description":"Latest mallOpenTime in ISO-8601 date-time; minimum must not exceed maximum.","maxLength":40,"format":"date-time"}},"required":[]},"example":{"regionId":211,"page":1,"size":3,"mallStarMin":4}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"columns":{"anyOf":[{"type":["array","null"],"description":"Render column definitions; business records are separate.","items":{}},{"type":"null"}]},"title":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: title."},{"type":"null"}]},"type":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: type."},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: sourceTool."},{"type":"null"}]},"sourceType":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: sourceType."},{"type":"null"}]},"items":{"anyOf":[{"type":["array","null"],"description":"Returned records, including valid empty results; preserve duplicate records and unknown fields.","items":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Provider id; preserve identifier and timestamp strings."},"mallId":{"type":["string","null"],"description":"Provider mallId; preserve identifier and timestamp strings."},"mallLogo":{"type":["string","null"],"description":"Provider mallLogo; preserve identifier and timestamp strings."},"mallName":{"type":["string","null"],"description":"Provider mallName; preserve identifier and timestamp strings."},"mallOpenTime":{"type":["string","null"],"description":"Provider mallOpenTime; preserve identifier and timestamp strings."},"createTime":{"type":["string","null"],"description":"Provider createTime; preserve identifier and timestamp strings."},"updateTime":{"type":["string","null"],"description":"Provider updateTime; preserve identifier and timestamp strings."},"regionId":{"type":["number","null"],"description":"Provider regionId; monetary values use the selected site's currency unless identified as supply prices."},"hot":{"type":["number","null"],"description":"Provider hot; monetary values use the selected site's currency unless identified as supply prices."},"mallStar":{"type":["number","null"],"description":"Provider mallStar; monetary values use the selected site's currency unless identified as supply prices."},"reviewNum":{"type":["number","null"],"description":"Provider reviewNum; monetary values use the selected site's currency unless identified as supply prices."},"goodsNum":{"type":["number","null"],"description":"Provider goodsNum; monetary values use the selected site's currency unless identified as supply prices."},"followerNum":{"type":["number","null"],"description":"Provider followerNum; monetary values use the selected site's currency unless identified as supply prices."},"mallSold":{"type":["number","null"],"description":"Provider mallSold; monetary values use the selected site's currency unless identified as supply prices."},"mallSales":{"type":["number","null"],"description":"Provider mallSales; monetary values use the selected site's currency unless identified as supply prices."},"avgPrice":{"type":["number","null"],"description":"Provider avgPrice; monetary values use the selected site's currency unless identified as supply prices."},"hostingMode":{"type":["number","null"],"description":"Provider hostingMode; monetary values use the selected site's currency unless identified as supply prices."},"catIds":{"type":["array","null"],"description":"Associated category identifiers.","items":{}},"catItems":{"type":["array","null"],"description":"Category paths: catId, catName, catLevel, parentCatId and isLeaf.","items":{}},"dayFollower":{"type":["number","null"],"description":"Provider day Follower metric; sales revenue uses site currency."},"dayFollowerRate":{"type":["number","null"],"description":"Provider growth rate for day Follower."},"dayItemCount":{"type":["number","null"],"description":"Provider day ItemCount metric; sales revenue uses site currency."},"dayItemCountRate":{"type":["number","null"],"description":"Provider growth rate for day ItemCount."},"daySales":{"type":["number","null"],"description":"Provider day Sales metric; sales revenue uses site currency."},"daySalesRate":{"type":["number","null"],"description":"Provider growth rate for day Sales."},"daySellthroughCount":{"type":["number","null"],"description":"Provider day SellthroughCount metric; sales revenue uses site currency."},"daySellthroughCountRate":{"type":["number","null"],"description":"Provider growth rate for day SellthroughCount."},"daySold":{"type":["number","null"],"description":"Provider day Sold metric; sales revenue uses site currency."},"daySoldRate":{"type":["number","null"],"description":"Provider growth rate for day Sold."},"weekFollower":{"type":["number","null"],"description":"Provider week Follower metric; sales revenue uses site currency."},"weekFollowerRate":{"type":["number","null"],"description":"Provider growth rate for week Follower."},"weekItemCount":{"type":["number","null"],"description":"Provider week ItemCount metric; sales revenue uses site currency."},"weekItemCountRate":{"type":["number","null"],"description":"Provider growth rate for week ItemCount."},"weekSales":{"type":["number","null"],"description":"Provider week Sales metric; sales revenue uses site currency."},"weekSalesRate":{"type":["number","null"],"description":"Provider growth rate for week Sales."},"weekSellthroughCount":{"type":["number","null"],"description":"Provider week SellthroughCount metric; sales revenue uses site currency."},"weekSellthroughCountRate":{"type":["number","null"],"description":"Provider growth rate for week SellthroughCount."},"weekSold":{"type":["number","null"],"description":"Provider week Sold metric; sales revenue uses site currency."},"weekSoldRate":{"type":["number","null"],"description":"Provider growth rate for week Sold."},"monthFollower":{"type":["number","null"],"description":"Provider month Follower metric; sales revenue uses site currency."},"monthFollowerRate":{"type":["number","null"],"description":"Provider growth rate for month Follower."},"monthItemCount":{"type":["number","null"],"description":"Provider month ItemCount metric; sales revenue uses site currency."},"monthItemCountRate":{"type":["number","null"],"description":"Provider growth rate for month ItemCount."},"monthSales":{"type":["number","null"],"description":"Provider month Sales metric; sales revenue uses site currency."},"monthSalesRate":{"type":["number","null"],"description":"Provider growth rate for month Sales."},"monthSellthroughCount":{"type":["number","null"],"description":"Provider month SellthroughCount metric; sales revenue uses site currency."},"monthSellthroughCountRate":{"type":["number","null"],"description":"Provider growth rate for month SellthroughCount."},"monthSold":{"type":["number","null"],"description":"Provider month Sold metric; sales revenue uses site currency."},"monthSoldRate":{"type":["number","null"],"description":"Provider growth rate for month Sold."}}}},{"type":"null"}]},"total":{"anyOf":[{"type":["integer","null"],"description":"Provider match count, possibly capped at 10000 for searches."},{"type":"null"}]},"regionId":{"anyOf":[{"type":["integer","null"],"description":"Region used for the query."},{"type":"null"}]},"page":{"anyOf":[{"type":["integer","null"],"description":"Current page."},{"type":"null"}]},"size":{"anyOf":[{"type":["integer","null"],"description":"Items per page."},{"type":"null"}]}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"columns":[],"items":[],"total":0,"regionId":211,"page":1,"size":3},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"geekbi-temu-mall-search","x-nexscope-mcp-tool-name":"nexscope_geekbi_temu_mall_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/geekbi-temu-goods-detail/run":{"post":{"tags":["Temu Marketplace Intelligence"],"summary":"Nexscope Temu Product Detail","description":"Execute the selected product detail operation and preserve provider business fields and extensions.","operationId":"runGeekbiTemuGoodsDetail","externalDocs":{"description":"Nexscope Temu Product Detail documentation","url":"https://www.nexscope.ai/api-docs/geekbi-temu-goods-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"goodsId":{"type":"string","description":"Product ID returned by product search.","minLength":1,"maxLength":100},"regionId":{"type":"integer","description":"Temu region from sites[].regionId; never siteId.","minimum":1,"default":211}},"required":["goodsId"]},"example":{"goodsId":"601100240999226","regionId":211}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"columns":{"anyOf":[{"type":["array","null"],"description":"Render column definitions; business records are separate.","items":{}},{"type":"null"}]},"title":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: title."},{"type":"null"}]},"type":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: type."},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: sourceTool."},{"type":"null"}]},"sourceType":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: sourceType."},{"type":"null"}]},"goods":{"anyOf":[{"type":["object","null"],"description":"Product object; nullable fields and extensions are preserved.","properties":{"isAd":{"anyOf":[{"type":["boolean","null"],"description":"Provider product flag: isAd."},{"type":"null"}]},"isCustom":{"anyOf":[{"type":["boolean","null"],"description":"Provider product flag: isCustom."},{"type":"null"}]},"isPresale":{"anyOf":[{"type":["boolean","null"],"description":"Provider product flag: isPresale."},{"type":"null"}]},"goodsId":{"anyOf":[{"type":["string","null"],"description":"Provider goodsId; preserve identifier and timestamp strings."},{"type":"null"}]},"mallId":{"anyOf":[{"type":["string","null"],"description":"Provider mallId; preserve identifier and timestamp strings."},{"type":"null"}]},"thumbnail":{"anyOf":[{"type":["string","null"],"description":"Provider thumbnail; preserve identifier and timestamp strings."},{"type":"null"}]},"goodsName":{"anyOf":[{"type":["string","null"],"description":"Provider goodsName; preserve identifier and timestamp strings."},{"type":"null"}]},"goodsNameCn":{"anyOf":[{"type":["string","null"],"description":"Provider goodsNameCn; preserve identifier and timestamp strings."},{"type":"null"}]},"goodsNameEn":{"anyOf":[{"type":["string","null"],"description":"Provider goodsNameEn; preserve identifier and timestamp strings."},{"type":"null"}]},"brand":{"anyOf":[{"type":["string","null"],"description":"Provider brand; preserve identifier and timestamp strings."},{"type":"null"}]},"sku":{"anyOf":[{"type":["string","null"],"description":"Provider sku; preserve identifier and timestamp strings."},{"type":"null"}]},"onSaleTime":{"anyOf":[{"type":["string","null"],"description":"Provider onSaleTime; preserve identifier and timestamp strings."},{"type":"null"}]},"mallOpenTime":{"anyOf":[{"type":["string","null"],"description":"Provider mallOpenTime; preserve identifier and timestamp strings."},{"type":"null"}]},"createTime":{"anyOf":[{"type":["string","null"],"description":"Provider createTime; preserve identifier and timestamp strings."},{"type":"null"}]},"updateTime":{"anyOf":[{"type":["string","null"],"description":"Provider updateTime; preserve identifier and timestamp strings."},{"type":"null"}]},"sold":{"anyOf":[{"type":["number","null"],"description":"Provider sold; monetary values use the selected site's currency unless identified as supply prices."},{"type":"null"}]},"quantity":{"anyOf":[{"type":["number","null"],"description":"Provider quantity; monetary values use the selected site's currency unless identified as supply prices."},{"type":"null"}]},"mallSold":{"anyOf":[{"type":["number","null"],"description":"Provider mallSold; monetary values use the selected site's currency unless identified as supply prices."},{"type":"null"}]},"sales":{"anyOf":[{"type":["number","null"],"description":"Provider sales; monetary values use the selected site's currency unless identified as supply prices."},{"type":"null"}]},"minPrice":{"anyOf":[{"type":["number","null"],"description":"Provider minPrice; monetary values use the selected site's currency unless identified as supply prices."},{"type":"null"}]},"maxPrice":{"anyOf":[{"type":["number","null"],"description":"Provider maxPrice; monetary values use the selected site's currency unless identified as supply prices."},{"type":"null"}]},"supplyPrice":{"anyOf":[{"type":["number","null"],"description":"Provider supplyPrice; monetary values use the selected site's currency unless identified as supply prices."},{"type":"null"}]},"minSupplyPrice":{"anyOf":[{"type":["number","null"],"description":"Provider minSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."},{"type":"null"}]},"medianSupplyPrice":{"anyOf":[{"type":["number","null"],"description":"Provider medianSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."},{"type":"null"}]},"maxSupplyPrice":{"anyOf":[{"type":["number","null"],"description":"Provider maxSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."},{"type":"null"}]},"goodsScore":{"anyOf":[{"type":["number","null"],"description":"Provider goodsScore; monetary values use the selected site's currency unless identified as supply prices."},{"type":"null"}]},"reviewNum":{"anyOf":[{"type":["number","null"],"description":"Provider reviewNum; monetary values use the selected site's currency unless identified as supply prices."},{"type":"null"}]},"hostingMode":{"anyOf":[{"type":["number","null"],"description":"Provider hostingMode; monetary values use the selected site's currency unless identified as supply prices."},{"type":"null"}]},"status":{"anyOf":[{"type":["number","null"],"description":"Provider status; monetary values use the selected site's currency unless identified as supply prices."},{"type":"null"}]},"similarNum":{"anyOf":[{"type":["number","null"],"description":"Provider similarNum; monetary values use the selected site's currency unless identified as supply prices."},{"type":"null"}]},"catIds":{"anyOf":[{"type":["array","null"],"description":"Associated category identifiers.","items":{}},{"type":"null"}]},"catItems":{"anyOf":[{"type":["array","null"],"description":"Category paths: catId, catName, catLevel, parentCatId and isLeaf.","items":{}},{"type":"null"}]},"daySold":{"anyOf":[{"type":["number","null"],"description":"Provider day Sold metric; sales revenue uses site currency."},{"type":"null"}]},"daySoldRate":{"anyOf":[{"type":["number","null"],"description":"Provider growth rate for day Sold."},{"type":"null"}]},"daySales":{"anyOf":[{"type":["number","null"],"description":"Provider day Sales metric; sales revenue uses site currency."},{"type":"null"}]},"daySalesRate":{"anyOf":[{"type":["number","null"],"description":"Provider growth rate for day Sales."},{"type":"null"}]},"weekSold":{"anyOf":[{"type":["number","null"],"description":"Provider week Sold metric; sales revenue uses site currency."},{"type":"null"}]},"weekSoldRate":{"anyOf":[{"type":["number","null"],"description":"Provider growth rate for week Sold."},{"type":"null"}]},"weekSales":{"anyOf":[{"type":["number","null"],"description":"Provider week Sales metric; sales revenue uses site currency."},{"type":"null"}]},"weekSalesRate":{"anyOf":[{"type":["number","null"],"description":"Provider growth rate for week Sales."},{"type":"null"}]},"monthSold":{"anyOf":[{"type":["number","null"],"description":"Provider month Sold metric; sales revenue uses site currency."},{"type":"null"}]},"monthSoldRate":{"anyOf":[{"type":["number","null"],"description":"Provider growth rate for month Sold."},{"type":"null"}]},"monthSales":{"anyOf":[{"type":["number","null"],"description":"Provider month Sales metric; sales revenue uses site currency."},{"type":"null"}]},"monthSalesRate":{"anyOf":[{"type":["number","null"],"description":"Provider growth rate for month Sales."},{"type":"null"}]}}},{"type":"null"}]},"history":{"anyOf":[{"type":["array","null"],"description":"History records from the last 30 days; optional provider metrics and time strings.","items":{"type":"object","properties":{"sold":{"type":["number","null"],"description":"Historical sold; monetary values use site currency."},"sales":{"type":["number","null"],"description":"Historical sales; monetary values use site currency."},"minPrice":{"type":["number","null"],"description":"Historical minPrice; monetary values use site currency."},"maxPrice":{"type":["number","null"],"description":"Historical maxPrice; monetary values use site currency."},"quantity":{"type":["number","null"],"description":"Historical quantity; monetary values use site currency."},"goodsScore":{"type":["number","null"],"description":"Historical goodsScore; monetary values use site currency."},"reviewNum":{"type":["number","null"],"description":"Historical reviewNum; monetary values use site currency."},"daySold":{"type":["number","null"],"description":"Historical daySold; monetary values use site currency."},"weekSold":{"type":["number","null"],"description":"Historical weekSold; monetary values use site currency."},"monthSold":{"type":["number","null"],"description":"Historical monthSold; monetary values use site currency."},"daySales":{"type":["number","null"],"description":"Historical daySales; monetary values use site currency."},"weekSales":{"type":["number","null"],"description":"Historical weekSales; monetary values use site currency."},"monthSales":{"type":["number","null"],"description":"Historical monthSales; monetary values use site currency."},"daySoldRate":{"type":["number","null"],"description":"Historical daySoldRate; monetary values use site currency."},"weekSoldRate":{"type":["number","null"],"description":"Historical weekSoldRate; monetary values use site currency."},"monthSoldRate":{"type":["number","null"],"description":"Historical monthSoldRate; monetary values use site currency."},"daySalesRate":{"type":["number","null"],"description":"Historical daySalesRate; monetary values use site currency."},"weekSalesRate":{"type":["number","null"],"description":"Historical weekSalesRate; monetary values use site currency."},"monthSalesRate":{"type":["number","null"],"description":"Historical monthSalesRate; monetary values use site currency."},"createTime":{"type":["string","null"],"description":"Unmodified provider history timestamp."}}}},{"type":"null"}]},"regionId":{"anyOf":[{"type":["integer","null"],"description":"Region used for the query."},{"type":"null"}]}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"columns":[],"goods":{},"history":[],"regionId":211},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"geekbi-temu-goods-detail","x-nexscope-mcp-tool-name":"nexscope_geekbi_temu_goods_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/geekbi-temu-goods-search/run":{"post":{"tags":["Temu Marketplace Intelligence"],"summary":"Nexscope Temu Product Search","description":"Execute the selected product search operation and preserve provider business fields and extensions.","operationId":"runGeekbiTemuGoodsSearch","externalDocs":{"description":"Nexscope Temu Product Search documentation","url":"https://www.nexscope.ai/api-docs/geekbi-temu-goods-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"regionId":{"type":"integer","description":"Temu region from sites[].regionId; never siteId.","minimum":1,"default":211},"page":{"type":"integer","description":"Page number.","minimum":1,"default":1},"size":{"type":"integer","description":"Items per page; page times size must not exceed 10000.","minimum":1,"maximum":200,"default":20},"keyword":{"type":"string","description":"User keyword; preserve the supplied language.","maxLength":300},"sort":{"type":"string","description":"Confirmed provider sort field; omit when unnecessary.","maxLength":100},"order":{"type":"string","description":"Sort direction, case-insensitive.","pattern":"^([aA][sS][cC]|[dD][eE][sS][cC])$"},"catIds":{"type":"array","description":"Category identifiers obtained from category lookup.","items":{"type":"integer","minimum":0}},"matchMode":{"type":"integer","description":"1 strict matching, 2 fuzzy matching.","enum":[1,2],"default":2},"status":{"type":"array","description":"1 normal, 2 out of stock, 3 delisted.","items":{"type":"integer","enum":[1,2,3]}},"hostingMode":{"type":"integer","description":"1 fully managed, 2 semi-managed.","enum":[1,2]},"soldMin":{"type":"integer","description":"Lower bound for sold; minimum must not exceed maximum.","minimum":0},"soldMax":{"type":"integer","description":"Upper bound for sold; minimum must not exceed maximum.","minimum":0},"daySoldMin":{"type":"integer","description":"Lower bound for daySold; minimum must not exceed maximum.","minimum":0},"daySoldMax":{"type":"integer","description":"Upper bound for daySold; minimum must not exceed maximum.","minimum":0},"weekSoldMin":{"type":"integer","description":"Lower bound for weekSold; minimum must not exceed maximum.","minimum":0},"weekSoldMax":{"type":"integer","description":"Upper bound for weekSold; minimum must not exceed maximum.","minimum":0},"monthSoldMin":{"type":"integer","description":"Lower bound for monthSold; minimum must not exceed maximum.","minimum":0},"monthSoldMax":{"type":"integer","description":"Upper bound for monthSold; minimum must not exceed maximum.","minimum":0},"quantityMin":{"type":"integer","description":"Lower bound for quantity; minimum must not exceed maximum.","minimum":0},"quantityMax":{"type":"integer","description":"Upper bound for quantity; minimum must not exceed maximum.","minimum":0},"mallSoldMin":{"type":"integer","description":"Lower bound for mallSold; minimum must not exceed maximum.","minimum":0},"mallSoldMax":{"type":"integer","description":"Upper bound for mallSold; minimum must not exceed maximum.","minimum":0},"reviewNumMin":{"type":"integer","description":"Lower bound for reviewNum; minimum must not exceed maximum.","minimum":0},"reviewNumMax":{"type":"integer","description":"Upper bound for reviewNum; minimum must not exceed maximum.","minimum":0},"salesMin":{"type":"number","description":"Lower bound for sales; minimum must not exceed maximum.","minimum":0},"salesMax":{"type":"number","description":"Upper bound for sales; minimum must not exceed maximum.","minimum":0},"daySalesMin":{"type":"number","description":"Lower bound for daySales; minimum must not exceed maximum.","minimum":0},"daySalesMax":{"type":"number","description":"Upper bound for daySales; minimum must not exceed maximum.","minimum":0},"weekSalesMin":{"type":"number","description":"Lower bound for weekSales; minimum must not exceed maximum.","minimum":0},"weekSalesMax":{"type":"number","description":"Upper bound for weekSales; minimum must not exceed maximum.","minimum":0},"monthSalesMin":{"type":"number","description":"Lower bound for monthSales; minimum must not exceed maximum.","minimum":0},"monthSalesMax":{"type":"number","description":"Upper bound for monthSales; minimum must not exceed maximum.","minimum":0},"priceMin":{"type":"number","description":"Lower bound for price; minimum must not exceed maximum.","minimum":0},"priceMax":{"type":"number","description":"Upper bound for price; minimum must not exceed maximum.","minimum":0},"supplyPriceMin":{"type":"number","description":"Lower bound for supplyPrice; minimum must not exceed maximum.","minimum":0},"supplyPriceMax":{"type":"number","description":"Upper bound for supplyPrice; minimum must not exceed maximum.","minimum":0},"daySoldRateMin":{"type":"number","description":"Lower bound for daySoldRate; minimum must not exceed maximum."},"daySoldRateMax":{"type":"number","description":"Upper bound for daySoldRate; minimum must not exceed maximum."},"weekSoldRateMin":{"type":"number","description":"Lower bound for weekSoldRate; minimum must not exceed maximum."},"weekSoldRateMax":{"type":"number","description":"Upper bound for weekSoldRate; minimum must not exceed maximum."},"monthSoldRateMin":{"type":"number","description":"Lower bound for monthSoldRate; minimum must not exceed maximum."},"monthSoldRateMax":{"type":"number","description":"Upper bound for monthSoldRate; minimum must not exceed maximum."},"daySalesRateMin":{"type":"number","description":"Lower bound for daySalesRate; minimum must not exceed maximum."},"daySalesRateMax":{"type":"number","description":"Upper bound for daySalesRate; minimum must not exceed maximum."},"weekSalesRateMin":{"type":"number","description":"Lower bound for weekSalesRate; minimum must not exceed maximum."},"weekSalesRateMax":{"type":"number","description":"Upper bound for weekSalesRate; minimum must not exceed maximum."},"monthSalesRateMin":{"type":"number","description":"Lower bound for monthSalesRate; minimum must not exceed maximum."},"monthSalesRateMax":{"type":"number","description":"Upper bound for monthSalesRate; minimum must not exceed maximum."},"goodsScoreMin":{"type":"number","description":"Lower bound for goodsScore; minimum must not exceed maximum.","minimum":0,"maximum":5},"goodsScoreMax":{"type":"number","description":"Upper bound for goodsScore; minimum must not exceed maximum.","minimum":0,"maximum":5},"onSaleTimeMin":{"type":"string","description":"Earliest onSaleTime in ISO-8601 date-time; minimum must not exceed maximum.","maxLength":40,"format":"date-time"},"onSaleTimeMax":{"type":"string","description":"Latest onSaleTime in ISO-8601 date-time; minimum must not exceed maximum.","maxLength":40,"format":"date-time"},"mallOpenTimeMin":{"type":"string","description":"Earliest mallOpenTime in ISO-8601 date-time; minimum must not exceed maximum.","maxLength":40,"format":"date-time"},"mallOpenTimeMax":{"type":"string","description":"Latest mallOpenTime in ISO-8601 date-time; minimum must not exceed maximum.","maxLength":40,"format":"date-time"}},"required":[]},"example":{"regionId":211,"page":1,"size":3,"keyword":"dress"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"columns":{"anyOf":[{"type":["array","null"],"description":"Render column definitions; business records are separate.","items":{}},{"type":"null"}]},"title":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: title."},{"type":"null"}]},"type":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: type."},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: sourceTool."},{"type":"null"}]},"sourceType":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: sourceType."},{"type":"null"}]},"items":{"anyOf":[{"type":["array","null"],"description":"Returned records, including valid empty results; preserve duplicate records and unknown fields.","items":{"type":"object","properties":{"isAd":{"type":["boolean","null"],"description":"Provider product flag: isAd."},"isCustom":{"type":["boolean","null"],"description":"Provider product flag: isCustom."},"isPresale":{"type":["boolean","null"],"description":"Provider product flag: isPresale."},"goodsId":{"type":["string","null"],"description":"Provider goodsId; preserve identifier and timestamp strings."},"mallId":{"type":["string","null"],"description":"Provider mallId; preserve identifier and timestamp strings."},"thumbnail":{"type":["string","null"],"description":"Provider thumbnail; preserve identifier and timestamp strings."},"goodsName":{"type":["string","null"],"description":"Provider goodsName; preserve identifier and timestamp strings."},"goodsNameCn":{"type":["string","null"],"description":"Provider goodsNameCn; preserve identifier and timestamp strings."},"goodsNameEn":{"type":["string","null"],"description":"Provider goodsNameEn; preserve identifier and timestamp strings."},"brand":{"type":["string","null"],"description":"Provider brand; preserve identifier and timestamp strings."},"sku":{"type":["string","null"],"description":"Provider sku; preserve identifier and timestamp strings."},"onSaleTime":{"type":["string","null"],"description":"Provider onSaleTime; preserve identifier and timestamp strings."},"mallOpenTime":{"type":["string","null"],"description":"Provider mallOpenTime; preserve identifier and timestamp strings."},"createTime":{"type":["string","null"],"description":"Provider createTime; preserve identifier and timestamp strings."},"updateTime":{"type":["string","null"],"description":"Provider updateTime; preserve identifier and timestamp strings."},"sold":{"type":["number","null"],"description":"Provider sold; monetary values use the selected site's currency unless identified as supply prices."},"quantity":{"type":["number","null"],"description":"Provider quantity; monetary values use the selected site's currency unless identified as supply prices."},"mallSold":{"type":["number","null"],"description":"Provider mallSold; monetary values use the selected site's currency unless identified as supply prices."},"sales":{"type":["number","null"],"description":"Provider sales; monetary values use the selected site's currency unless identified as supply prices."},"minPrice":{"type":["number","null"],"description":"Provider minPrice; monetary values use the selected site's currency unless identified as supply prices."},"maxPrice":{"type":["number","null"],"description":"Provider maxPrice; monetary values use the selected site's currency unless identified as supply prices."},"supplyPrice":{"type":["number","null"],"description":"Provider supplyPrice; monetary values use the selected site's currency unless identified as supply prices."},"minSupplyPrice":{"type":["number","null"],"description":"Provider minSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."},"medianSupplyPrice":{"type":["number","null"],"description":"Provider medianSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."},"maxSupplyPrice":{"type":["number","null"],"description":"Provider maxSupplyPrice; monetary values use the selected site's currency unless identified as supply prices."},"goodsScore":{"type":["number","null"],"description":"Provider goodsScore; monetary values use the selected site's currency unless identified as supply prices."},"reviewNum":{"type":["number","null"],"description":"Provider reviewNum; monetary values use the selected site's currency unless identified as supply prices."},"hostingMode":{"type":["number","null"],"description":"Provider hostingMode; monetary values use the selected site's currency unless identified as supply prices."},"status":{"type":["number","null"],"description":"Provider status; monetary values use the selected site's currency unless identified as supply prices."},"similarNum":{"type":["number","null"],"description":"Provider similarNum; monetary values use the selected site's currency unless identified as supply prices."},"catIds":{"type":["array","null"],"description":"Associated category identifiers.","items":{}},"catItems":{"type":["array","null"],"description":"Category paths: catId, catName, catLevel, parentCatId and isLeaf.","items":{}},"daySold":{"type":["number","null"],"description":"Provider day Sold metric; sales revenue uses site currency."},"daySoldRate":{"type":["number","null"],"description":"Provider growth rate for day Sold."},"daySales":{"type":["number","null"],"description":"Provider day Sales metric; sales revenue uses site currency."},"daySalesRate":{"type":["number","null"],"description":"Provider growth rate for day Sales."},"weekSold":{"type":["number","null"],"description":"Provider week Sold metric; sales revenue uses site currency."},"weekSoldRate":{"type":["number","null"],"description":"Provider growth rate for week Sold."},"weekSales":{"type":["number","null"],"description":"Provider week Sales metric; sales revenue uses site currency."},"weekSalesRate":{"type":["number","null"],"description":"Provider growth rate for week Sales."},"monthSold":{"type":["number","null"],"description":"Provider month Sold metric; sales revenue uses site currency."},"monthSoldRate":{"type":["number","null"],"description":"Provider growth rate for month Sold."},"monthSales":{"type":["number","null"],"description":"Provider month Sales metric; sales revenue uses site currency."},"monthSalesRate":{"type":["number","null"],"description":"Provider growth rate for month Sales."}}}},{"type":"null"}]},"total":{"anyOf":[{"type":["integer","null"],"description":"Provider match count, possibly capped at 10000 for searches."},{"type":"null"}]},"regionId":{"anyOf":[{"type":["integer","null"],"description":"Region used for the query."},{"type":"null"}]},"page":{"anyOf":[{"type":["integer","null"],"description":"Current page."},{"type":"null"}]},"size":{"anyOf":[{"type":["integer","null"],"description":"Items per page."},{"type":"null"}]}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"columns":[],"items":[],"total":0,"regionId":211,"page":1,"size":3},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"geekbi-temu-goods-search","x-nexscope-mcp-tool-name":"nexscope_geekbi_temu_goods_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/geekbi-temu-keyword-search/run":{"post":{"tags":["Temu Marketplace Intelligence"],"summary":"Nexscope Temu Keyword Research","description":"Execute the selected keyword research operation and preserve provider business fields and extensions.","operationId":"runGeekbiTemuKeywordSearch","externalDocs":{"description":"Nexscope Temu Keyword Research documentation","url":"https://www.nexscope.ai/api-docs/geekbi-temu-keyword-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"regionId":{"type":"integer","description":"Temu region from sites[].regionId; never siteId.","minimum":1,"default":211},"page":{"type":"integer","description":"Page number.","minimum":1,"default":1},"size":{"type":"integer","description":"Items per page; page times size must not exceed 10000.","minimum":1,"maximum":200,"default":20},"keyword":{"type":"string","description":"User keyword; preserve the supplied language.","maxLength":300},"sort":{"type":"string","description":"Confirmed provider sort field; omit when unnecessary.","maxLength":100},"order":{"type":"string","description":"Sort direction, case-insensitive.","pattern":"^([aA][sS][cC]|[dD][eE][sS][cC])$"},"dsrMin":{"type":"number","description":"Lower bound for dsr; minimum must not exceed maximum."},"dsrMax":{"type":"number","description":"Upper bound for dsr; minimum must not exceed maximum."},"totalSoldMin":{"type":"integer","description":"Lower bound for totalSold; minimum must not exceed maximum.","minimum":0},"totalSoldMax":{"type":"integer","description":"Upper bound for totalSold; minimum must not exceed maximum.","minimum":0},"itemCountMin":{"type":"integer","description":"Lower bound for itemCount; minimum must not exceed maximum.","minimum":0},"itemCountMax":{"type":"integer","description":"Upper bound for itemCount; minimum must not exceed maximum.","minimum":0},"mallCountMin":{"type":"integer","description":"Lower bound for mallCount; minimum must not exceed maximum.","minimum":0},"mallCountMax":{"type":"integer","description":"Upper bound for mallCount; minimum must not exceed maximum.","minimum":0},"avgPriceMin":{"type":"number","description":"Lower bound for avgPrice; minimum must not exceed maximum.","minimum":0},"avgPriceMax":{"type":"number","description":"Upper bound for avgPrice; minimum must not exceed maximum.","minimum":0},"totalSalesMin":{"type":"number","description":"Lower bound for totalSales; minimum must not exceed maximum.","minimum":0},"totalSalesMax":{"type":"number","description":"Upper bound for totalSales; minimum must not exceed maximum.","minimum":0},"catIds":{"type":"array","description":"Category identifiers obtained from category lookup.","items":{"type":"integer","minimum":0}},"firstOnSaleTimeMin":{"type":"string","description":"Earliest firstOnSaleTime in ISO-8601 date-time; minimum must not exceed maximum.","maxLength":40,"format":"date-time"},"firstOnSaleTimeMax":{"type":"string","description":"Latest firstOnSaleTime in ISO-8601 date-time; minimum must not exceed maximum.","maxLength":40,"format":"date-time"}},"required":[]},"example":{"regionId":211,"page":1,"size":3,"keyword":"dress"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"columns":{"anyOf":[{"type":["array","null"],"description":"Render column definitions; business records are separate.","items":{}},{"type":"null"}]},"title":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: title."},{"type":"null"}]},"type":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: type."},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: sourceTool."},{"type":"null"}]},"sourceType":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: sourceType."},{"type":"null"}]},"items":{"anyOf":[{"type":["array","null"],"description":"Returned records, including valid empty results; preserve duplicate records and unknown fields.","items":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Provider id; preserve identifier and timestamp strings."},"keyword":{"type":["string","null"],"description":"Provider keyword; preserve identifier and timestamp strings."},"cnKeyword":{"type":["string","null"],"description":"Provider cnKeyword; preserve identifier and timestamp strings."},"thumbnail":{"type":["string","null"],"description":"Provider thumbnail; preserve identifier and timestamp strings."},"firstOnSaleTime":{"type":["string","null"],"description":"Provider firstOnSaleTime; preserve identifier and timestamp strings."},"createTime":{"type":["string","null"],"description":"Provider createTime; preserve identifier and timestamp strings."},"updateTime":{"type":["string","null"],"description":"Provider updateTime; preserve identifier and timestamp strings."},"regionId":{"type":["number","null"],"description":"Provider regionId; monetary values use the selected site's currency unless identified as supply prices."},"dsr":{"type":["number","null"],"description":"Provider dsr; monetary values use the selected site's currency unless identified as supply prices."},"totalSold":{"type":["number","null"],"description":"Provider totalSold; monetary values use the selected site's currency unless identified as supply prices."},"totalSales":{"type":["number","null"],"description":"Provider totalSales; monetary values use the selected site's currency unless identified as supply prices."},"avgPrice":{"type":["number","null"],"description":"Provider avgPrice; monetary values use the selected site's currency unless identified as supply prices."},"itemCount":{"type":["number","null"],"description":"Provider itemCount; monetary values use the selected site's currency unless identified as supply prices."},"mallCount":{"type":["number","null"],"description":"Provider mallCount; monetary values use the selected site's currency unless identified as supply prices."},"semiManagedItemCount":{"type":["number","null"],"description":"Provider semiManagedItemCount; monetary values use the selected site's currency unless identified as supply prices."},"semiManagedMallCount":{"type":["number","null"],"description":"Provider semiManagedMallCount; monetary values use the selected site's currency unless identified as supply prices."},"catIds":{"type":["array","null"],"description":"Associated category identifiers.","items":{}},"catItems":{"type":["array","null"],"description":"Category paths: catId, catName, catLevel, parentCatId and isLeaf.","items":{}},"daySold":{"type":["number","null"],"description":"Provider day Sold metric; sales revenue uses site currency."},"daySoldRate":{"type":["number","null"],"description":"Provider growth rate for day Sold."},"daySales":{"type":["number","null"],"description":"Provider day Sales metric; sales revenue uses site currency."},"daySalesRate":{"type":["number","null"],"description":"Provider growth rate for day Sales."},"dayItemCount":{"type":["number","null"],"description":"Provider day ItemCount metric; sales revenue uses site currency."},"dayItemCountRate":{"type":["number","null"],"description":"Provider growth rate for day ItemCount."},"dayMallCount":{"type":["number","null"],"description":"Provider day MallCount metric; sales revenue uses site currency."},"dayMallCountRate":{"type":["number","null"],"description":"Provider growth rate for day MallCount."},"weekSold":{"type":["number","null"],"description":"Provider week Sold metric; sales revenue uses site currency."},"weekSoldRate":{"type":["number","null"],"description":"Provider growth rate for week Sold."},"weekSales":{"type":["number","null"],"description":"Provider week Sales metric; sales revenue uses site currency."},"weekSalesRate":{"type":["number","null"],"description":"Provider growth rate for week Sales."},"weekItemCount":{"type":["number","null"],"description":"Provider week ItemCount metric; sales revenue uses site currency."},"weekItemCountRate":{"type":["number","null"],"description":"Provider growth rate for week ItemCount."},"weekMallCount":{"type":["number","null"],"description":"Provider week MallCount metric; sales revenue uses site currency."},"weekMallCountRate":{"type":["number","null"],"description":"Provider growth rate for week MallCount."},"monthSold":{"type":["number","null"],"description":"Provider month Sold metric; sales revenue uses site currency."},"monthSoldRate":{"type":["number","null"],"description":"Provider growth rate for month Sold."},"monthSales":{"type":["number","null"],"description":"Provider month Sales metric; sales revenue uses site currency."},"monthSalesRate":{"type":["number","null"],"description":"Provider growth rate for month Sales."},"monthItemCount":{"type":["number","null"],"description":"Provider month ItemCount metric; sales revenue uses site currency."},"monthItemCountRate":{"type":["number","null"],"description":"Provider growth rate for month ItemCount."},"monthMallCount":{"type":["number","null"],"description":"Provider month MallCount metric; sales revenue uses site currency."},"monthMallCountRate":{"type":["number","null"],"description":"Provider growth rate for month MallCount."}}}},{"type":"null"}]},"total":{"anyOf":[{"type":["integer","null"],"description":"Provider match count, possibly capped at 10000 for searches."},{"type":"null"}]},"regionId":{"anyOf":[{"type":["integer","null"],"description":"Region used for the query."},{"type":"null"}]},"page":{"anyOf":[{"type":["integer","null"],"description":"Current page."},{"type":"null"}]},"size":{"anyOf":[{"type":["integer","null"],"description":"Items per page."},{"type":"null"}]}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"columns":[],"items":[],"total":0,"regionId":211,"page":1,"size":3},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"geekbi-temu-keyword-search","x-nexscope-mcp-tool-name":"nexscope_geekbi_temu_keyword_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/geekbi-temu-category-search/run":{"post":{"tags":["Temu Marketplace Intelligence"],"summary":"Nexscope Temu Category Research","description":"Execute the selected category research operation and preserve provider business fields and extensions.","operationId":"runGeekbiTemuCategorySearch","externalDocs":{"description":"Nexscope Temu Category Research documentation","url":"https://www.nexscope.ai/api-docs/geekbi-temu-category-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"regionId":{"type":"integer","description":"Temu region from sites[].regionId; never siteId.","minimum":1,"default":211},"page":{"type":"integer","description":"Page number.","minimum":1,"default":1},"size":{"type":"integer","description":"Items per page; page times size must not exceed 10000.","minimum":1,"maximum":200,"default":20},"keyword":{"type":"string","description":"User keyword; preserve the supplied language.","maxLength":300},"sort":{"type":"string","description":"Confirmed provider sort field; omit when unnecessary.","maxLength":100},"order":{"type":"string","description":"Sort direction, case-insensitive.","pattern":"^([aA][sS][cC]|[dD][eE][sS][cC])$"},"dsrMin":{"type":"number","description":"Lower bound for dsr; minimum must not exceed maximum."},"dsrMax":{"type":"number","description":"Upper bound for dsr; minimum must not exceed maximum."},"totalSoldMin":{"type":"integer","description":"Lower bound for totalSold; minimum must not exceed maximum.","minimum":0},"totalSoldMax":{"type":"integer","description":"Upper bound for totalSold; minimum must not exceed maximum.","minimum":0},"itemCountMin":{"type":"integer","description":"Lower bound for itemCount; minimum must not exceed maximum.","minimum":0},"itemCountMax":{"type":"integer","description":"Upper bound for itemCount; minimum must not exceed maximum.","minimum":0},"mallCountMin":{"type":"integer","description":"Lower bound for mallCount; minimum must not exceed maximum.","minimum":0},"mallCountMax":{"type":"integer","description":"Upper bound for mallCount; minimum must not exceed maximum.","minimum":0},"avgPriceMin":{"type":"number","description":"Lower bound for avgPrice; minimum must not exceed maximum.","minimum":0},"avgPriceMax":{"type":"number","description":"Upper bound for avgPrice; minimum must not exceed maximum.","minimum":0},"totalSalesMin":{"type":"number","description":"Lower bound for totalSales; minimum must not exceed maximum.","minimum":0},"totalSalesMax":{"type":"number","description":"Upper bound for totalSales; minimum must not exceed maximum.","minimum":0}},"required":[]},"example":{"regionId":211,"page":1,"size":3,"keyword":"pets"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"columns":{"anyOf":[{"type":["array","null"],"description":"Render column definitions; business records are separate.","items":{}},{"type":"null"}]},"title":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: title."},{"type":"null"}]},"type":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: type."},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: sourceTool."},{"type":"null"}]},"sourceType":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata: sourceType."},{"type":"null"}]},"items":{"anyOf":[{"type":["array","null"],"description":"Returned records, including valid empty results; preserve duplicate records and unknown fields.","items":{"type":"object","properties":{"catName":{"type":["string","null"],"description":"Provider catName; preserve identifier and timestamp strings."},"thumbnail":{"type":["string","null"],"description":"Provider thumbnail; preserve identifier and timestamp strings."},"createTime":{"type":["string","null"],"description":"Provider createTime; preserve identifier and timestamp strings."},"updateTime":{"type":["string","null"],"description":"Provider updateTime; preserve identifier and timestamp strings."},"regionId":{"type":["number","null"],"description":"Provider regionId; monetary values use the selected site's currency unless identified as supply prices."},"dsr":{"type":["number","null"],"description":"Provider dsr; monetary values use the selected site's currency unless identified as supply prices."},"totalSold":{"type":["number","null"],"description":"Provider totalSold; monetary values use the selected site's currency unless identified as supply prices."},"totalSales":{"type":["number","null"],"description":"Provider totalSales; monetary values use the selected site's currency unless identified as supply prices."},"avgPrice":{"type":["number","null"],"description":"Provider avgPrice; monetary values use the selected site's currency unless identified as supply prices."},"itemCount":{"type":["number","null"],"description":"Provider itemCount; monetary values use the selected site's currency unless identified as supply prices."},"mallCount":{"type":["number","null"],"description":"Provider mallCount; monetary values use the selected site's currency unless identified as supply prices."},"semiManagedItemCount":{"type":["number","null"],"description":"Provider semiManagedItemCount; monetary values use the selected site's currency unless identified as supply prices."},"semiManagedMallCount":{"type":["number","null"],"description":"Provider semiManagedMallCount; monetary values use the selected site's currency unless identified as supply prices."},"catId":{"type":["number","null"],"description":"Provider catId; monetary values use the selected site's currency unless identified as supply prices."},"optId":{"type":["number","null"],"description":"Provider optId; monetary values use the selected site's currency unless identified as supply prices."},"catLevel":{"type":["number","null"],"description":"Provider catLevel; monetary values use the selected site's currency unless identified as supply prices."},"parentCatId":{"type":["number","null"],"description":"Provider parentCatId; monetary values use the selected site's currency unless identified as supply prices."},"isLeaf":{"type":["boolean","null"],"description":"Whether this category is a leaf."},"parentCatItems":{"type":["array","null"],"description":"Full parent category path.","items":{}},"daySold":{"type":["number","null"],"description":"Provider day Sold metric; sales revenue uses site currency."},"daySoldRate":{"type":["number","null"],"description":"Provider growth rate for day Sold."},"daySales":{"type":["number","null"],"description":"Provider day Sales metric; sales revenue uses site currency."},"daySalesRate":{"type":["number","null"],"description":"Provider growth rate for day Sales."},"dayItemCount":{"type":["number","null"],"description":"Provider day ItemCount metric; sales revenue uses site currency."},"dayItemCountRate":{"type":["number","null"],"description":"Provider growth rate for day ItemCount."},"dayMallCount":{"type":["number","null"],"description":"Provider day MallCount metric; sales revenue uses site currency."},"dayMallCountRate":{"type":["number","null"],"description":"Provider growth rate for day MallCount."},"weekSold":{"type":["number","null"],"description":"Provider week Sold metric; sales revenue uses site currency."},"weekSoldRate":{"type":["number","null"],"description":"Provider growth rate for week Sold."},"weekSales":{"type":["number","null"],"description":"Provider week Sales metric; sales revenue uses site currency."},"weekSalesRate":{"type":["number","null"],"description":"Provider growth rate for week Sales."},"weekItemCount":{"type":["number","null"],"description":"Provider week ItemCount metric; sales revenue uses site currency."},"weekItemCountRate":{"type":["number","null"],"description":"Provider growth rate for week ItemCount."},"weekMallCount":{"type":["number","null"],"description":"Provider week MallCount metric; sales revenue uses site currency."},"weekMallCountRate":{"type":["number","null"],"description":"Provider growth rate for week MallCount."},"monthSold":{"type":["number","null"],"description":"Provider month Sold metric; sales revenue uses site currency."},"monthSoldRate":{"type":["number","null"],"description":"Provider growth rate for month Sold."},"monthSales":{"type":["number","null"],"description":"Provider month Sales metric; sales revenue uses site currency."},"monthSalesRate":{"type":["number","null"],"description":"Provider growth rate for month Sales."},"monthItemCount":{"type":["number","null"],"description":"Provider month ItemCount metric; sales revenue uses site currency."},"monthItemCountRate":{"type":["number","null"],"description":"Provider growth rate for month ItemCount."},"monthMallCount":{"type":["number","null"],"description":"Provider month MallCount metric; sales revenue uses site currency."},"monthMallCountRate":{"type":["number","null"],"description":"Provider growth rate for month MallCount."}}}},{"type":"null"}]},"total":{"anyOf":[{"type":["integer","null"],"description":"Provider match count, possibly capped at 10000 for searches."},{"type":"null"}]},"regionId":{"anyOf":[{"type":["integer","null"],"description":"Region used for the query."},{"type":"null"}]},"page":{"anyOf":[{"type":["integer","null"],"description":"Current page."},{"type":"null"}]},"size":{"anyOf":[{"type":["integer","null"],"description":"Items per page."},{"type":"null"}]}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"columns":[],"items":[],"total":0,"regionId":211,"page":1,"size":3},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"geekbi-temu-category-search","x-nexscope-mcp-tool-name":"nexscope_geekbi_temu_category_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/geekbi-temu-category-list/run":{"post":{"tags":["Temu Marketplace Intelligence"],"summary":"Nexscope Temu Category List","description":"Return provider category records without inventing search pagination fields.","operationId":"runGeekbiTemuCategoryList","externalDocs":{"description":"Nexscope Temu Category List documentation","url":"https://www.nexscope.ai/api-docs/geekbi-temu-category-list"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"parentCatId":{"minimum":0,"type":"integer"}},"additionalProperties":false,"type":"object"},"example":{}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":["integer","null"],"description":"Number of returned records."},{"type":"null"}]},"columns":{"anyOf":[{"type":["array","null"],"description":"Provider render column metadata.","items":{}},{"type":"null"}]},"title":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata."},{"type":"null"}]},"type":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata."},{"type":"null"}]},"sourceType":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata."},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata."},{"type":"null"}]},"categories":{"anyOf":[{"type":["array","null"],"description":"Category tree nodes.","items":{"type":"object","properties":{"catId":{"type":["integer","null"],"description":"Provider category identifier."},"catLevel":{"type":["integer","null"],"description":"Provider category identifier."},"parentCatId":{"type":["integer","null"],"description":"Provider category identifier."},"catName":{"type":["string","null"],"description":"Provider catName."},"isLeaf":{"type":["boolean","null"],"description":"Whether this category is a leaf."},"extraFields":{"type":["object","null"],"description":"Optional provider extension fields."}}}},{"type":"null"}]},"parentCatId":{"anyOf":[{"type":["integer","null"],"description":"Supplied parent category ID, if present."},{"type":"null"}]}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"columns":[],"total":0,"categories":[]},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"geekbi-temu-category-list","x-nexscope-mcp-tool-name":"nexscope_geekbi_temu_category_list","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/geekbi-temu-site-list/run":{"post":{"tags":["Temu Marketplace Intelligence"],"summary":"Nexscope Temu Site List","description":"Return provider site records without inventing search pagination fields.","operationId":"runGeekbiTemuSiteList","externalDocs":{"description":"Nexscope Temu Site List documentation","url":"https://www.nexscope.ai/api-docs/geekbi-temu-site-list"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"additionalProperties":false,"type":"object"},"example":{}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":["integer","null"],"description":"Number of returned records."},{"type":"null"}]},"columns":{"anyOf":[{"type":["array","null"],"description":"Provider render column metadata.","items":{}},{"type":"null"}]},"title":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata."},{"type":"null"}]},"type":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata."},{"type":"null"}]},"sourceType":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata."},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":["string","null"],"description":"Provider render/source metadata."},{"type":"null"}]},"sites":{"anyOf":[{"type":["array","null"],"description":"Supported Temu sites.","items":{"type":"object","properties":{"regionId":{"type":["integer","null"],"description":"Positive Temu region ID accepted by other endpoints."},"siteId":{"type":["integer","string","null"],"description":"Provider internal ID; do not use it as a regionId filter."},"name":{"type":["string","null"],"description":"Temu site name."},"cnName":{"type":["string","null"],"description":"Provider cnName."},"lang":{"type":["string","null"],"description":"Provider lang."},"currency":{"type":["string","null"],"description":"Provider currency."},"extraFields":{"type":["object","null"],"description":"Optional provider extension fields."}}}},{"type":"null"}]}},"additionalProperties":true,"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"columns":[],"sites":[],"total":0},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"geekbi-temu-site-list","x-nexscope-mcp-tool-name":"nexscope_geekbi_temu_site_list","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/1688-product-billboard/run":{"post":{"tags":["1688 Sourcing"],"summary":"1688 Product Billboard","description":"Query 1688 product bestseller billboard data for sourcing discovery and wholesale product research. Trigger when the user mentions 1688 product rankings, 1688 bestseller lists, wholesale hot products, domestic sourcing rankings, dropshipping product selection, 1688 trending products, bulk purchase popular items, supplier product rankings, 1688 billboard, 1688 bestsellers, sourcing rankings, wholesale hot products, trending product rankings, supplier rankings, 1688 trends. Even if the user does not explicitly mention \"1688 billboard\", if their need involves discovering hot-selling wholesale products or sourcing opportunities on the 1688 platform, this skill should also be triggered.","operationId":"run1688ProductBillboard","externalDocs":{"description":"1688 Product Billboard documentation","url":"https://www.nexscope.ai/api-docs/1688-product-billboard"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.1688-product-billboard.","properties":{"keyWord":{"type":"string","description":"Product search keyword (must be written in Simplified Chinese; translate it before calling this API). Maximum 50 characters","example":"iPhone 15"},"date":{"type":"string","description":"Query time. Weekly chart: pass the Sunday date of that week, e.g. 2025-06-15 (up to 90 days); Monthly chart: pass the first day of the month, e.g. 2025-06-01 (up to one year)","example":"2026-07-01"},"pageType":{"type":"integer","description":"Billboard type: 2 = weekly, 3 = monthly. Default 3","example":3},"pageIndex":{"type":"integer","description":"Page number (starting from 1), default 1","example":1},"pageSize":{"type":"integer","description":"Number of results per page (10-100), default 20","example":10},"sortField":{"type":"string","description":"Sort field, default orderCount. Options: orderCount (order count), saleCount (units sold), saleVolume (estimated sales amount), offerCreateTime (listing time), price (wholesale price), consignPrice (dropship price)"},"sortType":{"type":"string","description":"Sort order: desc (descending), asc (ascending), default desc"},"searchType":{"type":"integer","description":"Product keyword search type: 1 = fuzzy match, 3 = exact match. Default 1","example":1},"offerType":{"type":"integer","description":"Product tag: 0 = no limit, 2 = new product, 3 = 1688 Select, 4 = cross-border, 5 = customization supported, 6 = store highlight. Default 0","example":1},"companyType":{"type":"integer","description":"Company type: 0 = no limit, 1 = store, 2 = factory","example":1},"shiLiType":{"type":"string","description":"Seller membership type (multi-select), comma-separated. Options: superFactory (Super Factory), Power (Power Seller), TrustPass (TrustPass member only)"},"beginTpYear":{"type":"integer","description":"Start TrustPass years","example":1},"endTpYear":{"type":"integer","description":"End TrustPass years","example":1},"beginPrice":{"type":"number","description":"Wholesale price (start)","example":1},"endPrice":{"type":"number","description":"Wholesale price (end)","example":1},"beginConsignPrice":{"type":"number","description":"Dropship price (start)","example":1},"endConsignPrice":{"type":"number","description":"Dropship price (end)","example":1},"beginOrderCount":{"type":"integer","description":"Order count (start)","example":1},"endOrderCount":{"type":"integer","description":"Order count (end)","example":1},"beginSaleCount":{"type":"integer","description":"Units sold (start)","example":1},"endSaleCount":{"type":"integer","description":"Units sold (end)","example":1},"beginSaleVolume":{"type":"number","description":"Sales amount (start)","example":1},"endSaleVolume":{"type":"number","description":"Sales amount (end)","example":1},"beginStartQuantity":{"type":"integer","description":"Minimum order quantity (start)","example":1},"endStartQuantity":{"type":"integer","description":"Minimum order quantity (end)","example":1},"beginOfferCreateTime":{"type":"string","description":"Listing time (start), format: YYYY-MM-DD"},"endOfferCreateTime":{"type":"string","description":"Listing time (end), format: YYYY-MM-DD"},"sendTime":{"type":"string","description":"Delivery time (multi-select), comma-separated. Options: 24 (24 hours), 48 (48 hours), 72 (72 hours)"},"proxyRights":{"type":"string","description":"Dropship rights (multi-select), comma-separated. Options: 4360897 (one-piece dropship with free shipping), 449154 (procure now, pay later)"},"shopService":{"type":"string","description":"Seller services (multi-select), comma-separated. Options: 4057409 (Safe Buy), 888777 (Deep Verification Report)"},"buyerProtections":{"type":"string","description":"Buyer protections, comma-separated: free shipping, 7-day free return, or shipping insurance"},"faceToFaceSupport":{"type":"string","description":"Waybill support (multi-select), comma-separated. Options: 441218 (Taobao), 386434 (Douyin), 422914 (Pinduoduo), 422978 (Xiaohongshu), 386370 (Kuaishou)"},"productIds":{"type":"string","description":"Product IDs, separated by Chinese comma for multiple, max 20"},"goodsUrl":{"type":"string","description":"Product link URL","example":"https://example.com/image.jpg"}},"example":{"pageIndex":1,"searchType":1,"pageType":3,"pageSize":10,"date":"2026-07-01","keyWord":"iPhone 15"},"additionalProperties":true},"example":{"pageIndex":1,"searchType":1,"pageType":3,"pageSize":10,"date":"2026-07-01","keyWord":"iPhone 15"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total record count","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render columns","example":[]},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list (see Product Object below)","example":[],"items":{"type":"object","properties":{"offerId":{"type":"string","description":"Product ID","example":"example-id"},"asin":{"type":"string","description":"Product number","example":"B072MQ5BRX"},"title":{"type":"string","description":"Product title","example":null},"price":{"type":"number","description":"Wholesale price","example":1},"consignPrice":{"type":"number","description":"Dropship price","example":1},"currency":{"type":"string","description":"Currency","example":null},"unit":{"type":"string","description":"Unit","example":null},"quantityBegin":{"type":"integer","description":"Minimum order quantity","example":1},"quantityPrices":{"type":"string","description":"Price range","example":null},"salesOrderCount":{"type":"integer","description":"Order count (returns corresponding value based on statistical period)","example":1},"salesQuantity":{"type":"integer","description":"Units sold (returns corresponding value based on statistical period)","example":1},"estimatedSalesAmount":{"type":"integer","description":"Estimated sales amount (returns corresponding value based on statistical period)","example":1},"dataType":{"type":"string","description":"Data type: weeklyData = weekly data, monthlyData = monthly data","example":null},"availableDate":{"type":"string","description":"Product listing time, format yyyy-MM-dd HH:mm:ss","example":"2026-01-01"},"deliveryTime":{"type":"string","description":"Delivery time","example":null},"levelName":{"type":"string","description":"Category hierarchy name","example":null},"company":{"type":"string","description":"Store name","example":null},"shopId":{"type":"string","description":"Store ID","example":"example-id"},"shopUrl":{"type":"string","description":"Store link URL","example":"https://example.com/image.jpg"},"asinUrl":{"type":"string","description":"Product link URL","example":"https://detail.1688.com/offer/1040473674152.html"},"imageUrl":{"type":"string","description":"Image URL","example":"https://example.com/image.jpg"},"sourceType":{"type":"string","description":"Source platform (1688)","example":null},"sourceTool":{"type":"string","description":"Source tool","example":null}}}},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"columns":[],"products":[{"offerId":"example-id","asin":"B072MQ5BRX","price":1,"consignPrice":1,"quantityBegin":1,"salesOrderCount":1,"salesQuantity":1,"estimatedSalesAmount":1,"availableDate":"2026-01-01","shopId":"example-id","shopUrl":"https://example.com/image.jpg","asinUrl":"https://detail.1688.com/offer/1040473674152.html","imageUrl":"https://example.com/image.jpg"}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"1688-product-billboard","x-nexscope-mcp-tool-name":"nexscope_1688_product_billboard","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/1688-product-search/run":{"post":{"tags":["1688 Sourcing"],"summary":"1688 Product Search","description":"Search and analyze products on the Chinese 1688 wholesale platform (Alibaba domestic B2B market) for sourcing, supplier discovery, and product selection. Trigger when the user mentions 1688 product search, finding suppliers on 1688, wholesale product queries, factory sourcing, dropshipping supplier search, 1688 keyword product selection, wholesale price comparison, filtering by sales volume, any product research on the 1688 platform, 1688 search, 1688 product selection, find suppliers, factory lookup, wholesale pricing, supplier search, domestic sourcing, 1688 products. Even if the user does not explicitly say \"1688\", if their need involves searching for wholesale products, finding domestic suppliers, or sourcing from the domestic Chinese market, this skill should also be triggered.","operationId":"run1688ProductSearch","externalDocs":{"description":"1688 Product Search documentation","url":"https://www.nexscope.ai/api-docs/1688-product-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.1688-product-search.","properties":{"keyWord":{"type":"string","description":"Search keyword (must be written in Simplified Chinese; maximum 50 characters)","example":"iPhone 15"},"goodsUrl":{"type":"string","description":"Product link URL (mutually exclusive with keyWord)","example":"https://example.com/image.jpg"},"productIds":{"type":"string","description":"Product IDs, comma-separated, max 20"},"cycle":{"type":"string","description":"Statistical period: 7 (last 7 days) or 30 (last 30 days)"},"searchType":{"type":"integer","description":"Search type: 1 = fuzzy match, 3 = exact match","example":1},"sortField":{"type":"string","description":"Sort field: orderCount7d, saleCount7d, saleVolume7d, orderCount30d, saleCount30d, saleVolume30d, offerCreateTime, price, consignPrice"},"sortType":{"type":"string","description":"Sort order: desc (descending), asc (ascending)"},"pageIndex":{"type":"integer","description":"Page number (starting from 1)","example":1},"pageSize":{"type":"integer","description":"Results per page (10-100)","example":10},"beginPrice":{"type":"number","description":"Wholesale price (start)","example":1},"endPrice":{"type":"number","description":"Wholesale price (end)","example":1},"beginConsignPrice":{"type":"number","description":"Dropship price (start)","example":1},"endConsignPrice":{"type":"number","description":"Dropship price (end)","example":1},"beginOrderCount":{"type":"integer","description":"Order count (start)","example":1},"endOrderCount":{"type":"integer","description":"Order count (end)","example":1},"beginSaleCount":{"type":"integer","description":"Units sold (start)","example":1},"endSaleCount":{"type":"integer","description":"Units sold (end)","example":1},"beginSaleVolume":{"type":"number","description":"Sales amount (start)","example":1},"endSaleVolume":{"type":"number","description":"Sales amount (end)","example":1},"beginStartQuantity":{"type":"integer","description":"Minimum purchase quantity (start)","example":1},"endStartQuantity":{"type":"integer","description":"Minimum purchase quantity (end)","example":1},"beginTpYear":{"type":"integer","description":"TrustPass years (start)","example":1},"endTpYear":{"type":"integer","description":"TrustPass years (end)","example":1},"beginOfferCreateTime":{"type":"string","description":"Listing time start (format: YYYY-MM-DD)"},"endOfferCreateTime":{"type":"string","description":"Listing time end (format: YYYY-MM-DD)"},"companyType":{"type":"integer","description":"Company type: 0 = no limit, 1 = store, 2 = factory","example":1},"offerType":{"type":"integer","description":"Product tag: 0 = no limit, 2 = new product, 3 = 1688 Select, 4 = cross-border, 5 = customization supported, 6 = store highlight","example":1},"shiLiType":{"type":"string","description":"Seller type (multi-select, comma-separated): superFactory (Super Factory), Power (Power Seller), TrustPass (TrustPass)"},"sendTime":{"type":"string","description":"Delivery time (multi-select, comma-separated): 24, 48, 72"},"faceToFaceSupport":{"type":"string","description":"Waybill support (multi-select, comma-separated): 441218 (Taobao), 386434 (Douyin), 422914 (Pinduoduo), 422978 (Xiaohongshu), 386370 (Kuaishou)"},"proxyRights":{"type":"string","description":"Dropship rights (multi-select, comma-separated): 4360897 (one-piece dropship with free shipping), 449154 (procure now, pay later)"},"shopService":{"type":"string","description":"Seller services (multi-select, comma-separated): 4057409 (Safe Buy), 888777 (Deep Verification Report)"},"buyerProtections":{"type":"string","description":"Buyer protections, comma-separated: free shipping, 7-day free return, or shipping insurance"}},"example":{"pageIndex":1,"searchType":1,"keyWord":"iPhone 15","pageSize":10},"additionalProperties":true},"example":{"pageIndex":1,"searchType":1,"keyWord":"iPhone 15","pageSize":10}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total record count","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render column definitions","example":[]},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list (see fields below)","example":[],"items":{"type":"object","properties":{"offerId":{"type":"string","description":"Product ID","example":"example-id"},"asin":{"type":"string","description":"Product number","example":"B072MQ5BRX"},"title":{"type":"string","description":"Product title","example":null},"asinUrl":{"type":"string","description":"Product link URL","example":"https://detail.1688.com/offer/1040473674152.html"},"imageUrl":{"type":"string","description":"Product image URL","example":"https://example.com/image.jpg"},"price":{"type":"number","description":"Wholesale price","example":1},"consignPrice":{"type":"number","description":"Dropship price","example":1},"quantityPrices":{"type":"string","description":"Price range","example":null},"quantityBegin":{"type":"integer","description":"Minimum order quantity","example":1},"unit":{"type":"string","description":"Unit","example":null},"currency":{"type":"string","description":"Currency","example":null},"salesOrderCount":{"type":"integer","description":"Order count (by statistical period)","example":1},"salesQuantity":{"type":"integer","description":"Units sold (by statistical period)","example":1},"estimatedSalesAmount":{"type":"integer","description":"Estimated sales amount (by statistical period)","example":1},"deliveryTime":{"type":"string","description":"Delivery time","example":null},"availableDate":{"type":"string","description":"Product listing time","example":"2026-01-01"},"levelName":{"type":"string","description":"Category hierarchy name","example":null},"company":{"type":"string","description":"Store name","example":null},"shopId":{"type":"string","description":"Store ID","example":"example-id"},"shopUrl":{"type":"string","description":"Store link URL","example":"https://example.com/image.jpg"},"dataType":{"type":"string","description":"Data type: weeklyData (weekly data), monthlyData (monthly data)","example":null},"sourceType":{"type":"string","description":"Source platform (1688)","example":null},"sourceTool":{"type":"string","description":"Source tool","example":null}}}},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"columns":[],"products":[{"offerId":"example-id","asin":"B072MQ5BRX","asinUrl":"https://detail.1688.com/offer/1040473674152.html","imageUrl":"https://example.com/image.jpg","price":1,"consignPrice":1,"quantityBegin":1,"salesOrderCount":1,"salesQuantity":1,"estimatedSalesAmount":1,"availableDate":"2026-01-01","shopId":"example-id","shopUrl":"https://example.com/image.jpg"}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"1688-product-search","x-nexscope-mcp-tool-name":"nexscope_1688_product_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/1688-search-by-image/run":{"post":{"tags":["1688 Sourcing"],"summary":"1688 Search By Image","description":"Perform image-based product search on the 1688 platform. Use an image URL to find visually similar supplier products, returning title, price, minimum order quantity, monthly sales, repurchase rate, trade score, and seller identity. Triggered when users mention 1688 image search, 1688 visual search, find supplier by image, reverse image search 1688, 1688 product sourcing by image, or Alibaba 1688 image search. Even if the user does not explicitly mention \"image search,\" this skill should be triggered whenever a user provides an image URL and wants to find matching or similar products on the 1688 wholesale platform.","operationId":"run1688SearchByImage","externalDocs":{"description":"1688 Search By Image documentation","url":"https://www.nexscope.ai/api-docs/1688-search-by-image"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imageUrl":{"type":"string","description":"Public HTTP/80 or HTTPS/443 URL, maximum 1,000 characters, without redirects. A sole direct source is checked for PNG/JPEG headers, at most 14.3 MiB, each dimension at most 20,000 and at most 40,000,000 pixels. This is not full pixel-integrity validation. imageId or ambiguous multiple sources preserve provider behavior and skip new preflight. Provide at least one image source.","example":"https://m.media-amazon.com/images/I/61v6nYvQ7+L._AC_SL1500_.jpg"},"imageBase64":{"type":"string","description":"Raw standard Base64 for PNG/JPEG; optional padding and outer whitespace allowed, embedded whitespace and data URI prefixes rejected for a sole direct source. Byte/header limits match imageUrl; at most 19,992,848 Base64 characters after outer whitespace trimming. Multiple-source inputs retain existing provider behavior.","example":null},"imageId":{"type":"string","description":"1688 image ID. Image-search results also return this value; include it when page is greater than 1 to improve response time","example":null},"page":{"type":"integer","description":"Page number starting from 1","example":1},"pageSize":{"type":"integer","description":"Number of products per page, maximum 50","example":10},"priceStart":{"type":"string","description":"Minimum price in CNY, for example 10","example":null},"priceEnd":{"type":"string","description":"Maximum price in CNY, for example 100","example":null},"filter":{"type":"string","description":"Comma-separated filter conditions. Use the supported filter values documented for this endpoint","example":null},"sort":{"type":"string","description":"Sort condition as JSON in the form {field: direction}. Fields: price, rePurchaseRate, or monthSold. Directions: asc or desc","example":null},"keyword":{"type":"string","description":"Keyword used to search within the results","example":"phone case"},"productCollectionId":{"type":"string","description":"Single product-collection ID. Use a supported collection ID documented for this endpoint","example":"example-id"}},"required":[],"additionalProperties":true},"example":{"page":1,"pageSize":10,"imageUrl":"https://m.media-amazon.com/images/I/61v6nYvQ7+L._AC_SL1500_.jpg"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"imageId":{"anyOf":[{"type":"string","description":"Uploaded image ID; send it with paginated requests to improve response time","example":"example-id"},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"Number of products on this page","example":1},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total number of pages","example":1},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type; fixed value \"1688\"","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendering style; fixed value \"productWorkbenches\"","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions used for rendering","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list; see the product fields below","example":[],"items":{"type":"object","properties":{"offerId":{"type":"string","description":"Product ID","example":"example-id"},"asin":{"type":"string","description":"Product identifier, same as offerId","example":"example-id"},"imageUrl":{"type":"string","description":"Product image URL","example":"https://example.com/image.jpg"},"title":{"type":"string","description":"Product title","example":null},"price":{"type":"number","description":"Wholesale price in CNY","example":1},"consignPrice":{"type":"number","description":"Single-item dropshipping price in CNY","example":1},"salesQuantity":{"type":"integer","description":"Monthly units sold","example":1},"estimatedSalesAmount":{"type":"number","description":"Estimated sales revenue","example":1},"asinUrl":{"type":"string","description":"Product URL","example":"https://detail.1688.com/offer/1040473674152.html"},"isOnePsale":{"type":"boolean","description":"Whether single-item dropshipping is available","example":null},"isJxhy":{"type":"boolean","description":"Whether the product is a selected supply source","example":null},"sellerIdentities":{"type":"string","description":"Seller identities, such as Super Factory, Verified Supplier, or TrustPass member","example":null},"offerIdentities":{"type":"string","description":"Product badge, such as Strict Selection","example":null},"repurchaseRate":{"type":"string","description":"Repurchase rate","example":null},"tradeScore":{"type":"string","description":"Product transaction score","example":null},"compositeServiceScore":{"type":"string","description":"Composite service-experience score","example":null},"sendGoodsAddressText":{"type":"string","description":"Dispatch location","example":null},"deliveryTime":{"type":"string","description":"Dispatch time, such as 24 or 48 hours","example":null},"quantityBegin":{"type":"integer","description":"Minimum order quantity","example":1},"hasPromotion":{"type":"boolean","description":"Whether a promotion is active","example":null},"promotionType":{"type":"string","description":"Promotion type","example":null},"isPatentProduct":{"type":"boolean","description":"Whether the product is patented","example":null},"isSelect":{"type":"boolean","description":"Cross-border Select collection indicator","example":null},"currency":{"type":"string","description":"Currency; fixed value \"¥\"","example":null},"sourceType":{"type":"string","description":"Source type; fixed value \"1688\"","example":null},"sourceTool":{"type":"string","description":"Source tool; fixed value identifying 1688 image search","example":null},"dataType":{"type":"string","description":"Data type; fixed value \"monthlyData\"","example":null}}}},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"imageId":"example-id","total":1,"totalPage":1,"columns":[],"costToken":1,"products":[{"offerId":"example-id","asin":"example-id","imageUrl":"https://example.com/image.jpg","price":1,"consignPrice":1,"salesQuantity":1,"estimatedSalesAmount":1,"asinUrl":"https://detail.1688.com/offer/1040473674152.html","quantityBegin":1}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"1688-search-by-image","x-nexscope-mcp-tool-name":"nexscope_1688_search_by_image","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-ads-api-access/run":{"post":{"tags":["Amazon Advertising"],"summary":"Amazon Ads API Access","description":"Starts Amazon Ads OAuth authorization or returns safe connection and profile metadata. Access and refresh tokens are never accepted or returned.","operationId":"runAmazonAdsApiAccess","externalDocs":{"description":"Amazon Ads API Access documentation","url":"https://www.nexscope.ai/api-docs/amazon-ads-api-access"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Operation-specific inputs: authorize requires region and marketplaceId; profiles requires connectionId; connections requires no additional input. Connections are scoped to the API-key owner, and OAuth tokens are backend-owned.","properties":{"operation":{"type":"string","description":"Operation: authorize, connections, or profiles.","example":"authorize"},"region":{"type":"string","description":"Required when operation=authorize. Amazon Ads region: NA, EU, or FE.","example":"NA"},"marketplaceId":{"type":"string","description":"Required when operation=authorize. Amazon marketplace identifier.","example":"ATVPDKIKX0DER"},"accountName":{"type":"string","description":"Optional display name for the authorization request.","example":"US Ads account"},"connectionId":{"type":"integer","description":"Required when operation=profiles. Owned Amazon Ads connection ID.","example":123}},"required":["operation","region","marketplaceId"],"example":{"operation":"authorize","marketplaceId":"ATVPDKIKX0DER","region":"NA","accountName":"US Ads account"},"additionalProperties":true},"example":{"operation":"authorize","marketplaceId":"ATVPDKIKX0DER","region":"NA","accountName":"US Ads account"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"authorizationUrl":{"anyOf":[{"type":"string","description":"OAuth URL to open in a browser.","example":"https://example.com/authorize"},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"Opaque OAuth state used only by the backend callback.","example":"opaque-state"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"integer","description":"Authorization state expiry timestamp in milliseconds.","example":1760000000000},{"type":"null"}]},"connections":{"anyOf":[{"type":"array","description":"Safe owned Amazon Ads connection metadata.","example":[]},{"type":"null"}]},"profiles":{"anyOf":[{"type":"array","description":"Safe Amazon Ads profiles for the selected connection.","example":[],"items":{"type":"object","properties":{"profileId":{"type":"string","description":"Amazon Ads profile ID.","example":"123456789"},"countryCode":{"type":"string","description":"Profile country code.","example":"US"},"currencyCode":{"type":"string","description":"Profile currency code.","example":"USD"}}}},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"authorizationUrl":"https://example.com/authorize","state":"opaque-state","expiresAt":1760000000000,"connections":[],"profiles":[{"profileId":"123456789","countryCode":"US","currencyCode":"USD"}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-ads-api-access","x-nexscope-mcp-tool-name":"nexscope_amazon_ads_api_access","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-ads-reporting/run":{"post":{"tags":["Amazon Advertising"],"summary":"Amazon Ads Reporting","description":"Uses the source get_report contract: omit reportId to create, supply reportId to poll, or supply a backend documentToken to download.","operationId":"runAmazonAdsReporting","externalDocs":{"description":"Amazon Ads Reporting documentation","url":"https://www.nexscope.ai/api-docs/amazon-ads-reporting"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Create requires startDate/endDate plus configuration, or startDate/endDate plus reportTypeId/adProduct/groupBy/columns. Poll requires reportId. Download requires documentToken.","properties":{"connectionId":{"type":"integer","description":"Owned Amazon Ads connection ID.","example":123},"reportId":{"type":"string","description":"Existing report ID; when present the API polls that report.","example":"report-id"},"reportTypeId":{"type":"string","description":"Report type required by a new report unless configuration supplies it.","example":"spCampaigns"},"adProduct":{"type":"string","description":"Ad product required by a new report unless configuration supplies it.","example":"SPONSORED_PRODUCTS"},"groupBy":{"type":"array","items":{"type":"string"},"description":"Report grouping fields.","example":["campaign"]},"columns":{"type":"array","items":{"type":"string"},"description":"Requested report columns.","example":["campaignId","impressions","clicks"]},"name":{"type":"string","description":"Optional report name.","example":"Campaign report"},"startDate":{"type":"string","description":"Inclusive report start date for a new report.","example":"2026-07-01"},"endDate":{"type":"string","description":"Inclusive report end date for a new report.","example":"2026-07-31"},"timeUnit":{"type":"string","description":"Optional report time unit.","example":"DAILY"},"format":{"type":"string","description":"Optional report format.","example":"GZIP_JSON"},"filters":{"type":"array","items":{},"description":"Optional report filters.","example":[]},"configuration":{"type":"object","description":"Complete Amazon Ads reporting configuration; may replace reportTypeId/adProduct/groupBy/columns.","example":{},"properties":{},"additionalProperties":true},"documentToken":{"type":"string","description":"Backend-issued token for downloading a completed report.","example":"opaque-document-token"}},"required":["connectionId"],"example":{"startDate":"2026-07-01","reportTypeId":"spCampaigns","adProduct":"SPONSORED_PRODUCTS","connectionId":123,"groupBy":["campaign"],"endDate":"2026-07-31","columns":["campaignId","impressions"]},"additionalProperties":true},"example":{"startDate":"2026-07-01","reportTypeId":"spCampaigns","adProduct":"SPONSORED_PRODUCTS","connectionId":123,"groupBy":["campaign"],"endDate":"2026-07-31","columns":["campaignId","impressions"]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"status":{"anyOf":[{"type":"string","description":"Report status.","example":"PENDING"},{"type":"null"}]},"reportId":{"anyOf":[{"type":"string","description":"Provider report ID.","example":"report-id"},{"type":"null"}]},"documentToken":{"anyOf":[{"type":"string","description":"Safe opaque token used for download.","example":"opaque-document-token"},{"type":"null"}]},"content":{"anyOf":[{"type":["object","array","string"],"description":"Downloaded report content when available.","example":{}},{"type":"null"}]},"contentType":{"anyOf":[{"type":"string","description":"Downloaded report content type.","example":"application/json"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"status":"PENDING","reportId":"report-id","documentToken":"opaque-document-token","content":{},"contentType":"application/json"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-ads-reporting","x-nexscope-mcp-tool-name":"nexscope_amazon_ads_reporting","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-advertising/run":{"post":{"tags":["Amazon Advertising"],"summary":"Amazon Advertising","description":"Accepts only documented ads_manager.sb/sd/sp operation IDs. Provider methods and paths are derived server-side; mutations require preview followed by confirmation.","operationId":"runAmazonAdvertising","externalDocs":{"description":"Amazon Advertising documentation","url":"https://www.nexscope.ai/api-docs/amazon-advertising"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"The API key owner must own connectionId. Raw provider method, path, content type, and workspace are not accepted.","properties":{"operationId":{"type":"string","description":"Exact catalog operation ID, for example ads_manager.sp.list_campaigns.","example":"ads_manager.sp.list_campaigns"},"connectionId":{"type":"integer","description":"Owned Amazon Ads connection ID.","example":123},"payload":{"type":"object","description":"Documented fields for the selected operation; required by create/update operations. SP POST /list filters such as campaignIdFilter and stateFilter belong in payload as objects with non-empty include arrays of strings.","example":{"campaignIdFilter":{"include":["123456789"]},"maxResults":10},"properties":{},"additionalProperties":true},"queryString":{"type":"string","description":"Optional operation-specific query string without a leading ?; do not use it for SP POST /list filters.","example":""},"adType":{"type":"string","description":"Required only by ads_manager.sb.create_ads.","example":"video"},"action":{"type":"string","description":"preview (default) or confirm for mutations; ignored for reads.","example":"preview"},"confirmationToken":{"type":"string","description":"Single-use token required when action is confirm.","example":"opaque-token"}},"required":["operationId","connectionId"],"example":{"payload":{"campaignIdFilter":{"include":["123456789"]},"maxResults":10},"operationId":"ads_manager.sp.list_campaigns","connectionId":123},"additionalProperties":true},"example":{"payload":{"campaignIdFilter":{"include":["123456789"]},"maxResults":10},"operationId":"ads_manager.sp.list_campaigns","connectionId":123}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"object","description":"Safe Amazon Ads provider result.","example":{}},{"type":"null"}]},"confirmationToken":{"anyOf":[{"type":"string","description":"Single-use mutation confirmation token returned by preview.","example":"opaque-token"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"integer","description":"Confirmation expiry timestamp when returned.","example":1760000000000},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":{},"confirmationToken":"opaque-token","expiresAt":1760000000000},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-advertising","x-nexscope-mcp-tool-name":"nexscope_amazon_advertising","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-asin-keywords/run":{"post":{"tags":["Keyword & Search Demand"],"summary":"Amazon Asin Keywords","description":"Use Nexscope data to reverse-lookup traffic keywords for any Amazon ASIN, including organic ranking, ad ranking, search volume, traffic share, organic/paid scores, ABA TOP3 click concentration, click conversion rate, year-over-year search volume changes, and weekly/monthly time windows. Trigger when the user mentions ASIN keyword analysis, ASIN reverse lookup, traffic keyword research, organic ranking query, ad ranking query, keyword position tracking, Nexscope keyword data, competitor keyword peeking, viewing which keywords drive traffic to a product, analyzing keyword performance for a specific ASIN, time windows by week/month/recent N days, ASIN reverse keyword lookup, traffic keywords, organic ranking, ad ranking, search volume, Nexscope keywords, competitor keyword reverse lookup, click concentration, click-to-purchase conversion, week-over-week search volume. Even if the user does not explicitly mention \"Nexscope\", if their need involves finding keywords associated with a specific Amazon product (ASIN), this skill should also be triggered.","operationId":"runAmazonAsinKeywords","externalDocs":{"description":"Amazon Asin Keywords documentation","url":"https://www.nexscope.ai/api-docs/amazon-asin-keywords"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-asin-keywords.","properties":{"asin":{"type":"string","description":"ASIN code, max length 1000 characters. This tool can only query one ASIN at a time","example":"B072MQ5BRX"},"country":{"type":"string","description":"Country site, default US. Options (13 total): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA"},"keyword":{"type":"string","description":"Keyword, max length 1000. Translate to the corresponding country's language whenever possible","example":"phone case"},"timePieceType":{"type":"string","description":"Time slice type, default latelyDay. Options: latelyDay (last N days), month (a specific month), week (a specific week)"},"timePieceValue":{"type":"string","description":"Time slice value, default 7, max length 1000. For latelyDay only 7 or 30; for month format YYYY-MM (e.g. 2026-04); for week format week start date YYYY-MM-DD (e.g. 2026-04-13)"},"conditions":{"type":"string","description":"Condition filters, comma-separated. Options:<br>Flag type: nfPosition (natural traffic keyword), isSpAd (SP ad keyword), isBrandAd (brand ad keyword), isVedioAd (video ad keyword), isAC (AC recommended keyword), isAccurateKw (precise traffic keyword), isAccurateTailKw (precise long-tail keyword), isPurchaseKw (converting keyword), isQualityKw (high-quality conversion keyword), isStableKw (stable conversion keyword), isLossKw (lost conversion keyword), isInvalidKw (invalid impression keyword), isMultiVariantKw (multi-variant natural rank keyword), isSearchVolUpKw (search volume YoY growth keyword), isSearchVolDownKw (search volume YoY decline keyword)<br>Period count type (.total all / .in new): totalPeriod.in, nfKeywordCnt.total, nfKeywordCnt.in, adKeywordCnt.total, adKeywordCnt.in, allSpKeywordCnt.total, allSpKeywordCnt.in, spKeywordCnt.total, spKeywordCnt.in, recSpKeywordCnt.total, recSpKeywordCnt.in, allSbKeywordCnt.total, allSbKeywordCnt.in, sbKeywordCnt.total, sbKeywordCnt.in, sbvKeywordCnt.total, sbvKeywordCnt.in"},"sortBy":{"type":"string","description":"Sort field. Options: lastRank (natural rank), adLastRank (ad rank), updateTime (keyword crawl time), searchesRank (search rank), estSearchesNum (monthly search volume). Empty string means default system sort"},"desc":{"type":"boolean","description":"Whether to sort descending, default true","example":false},"pageNum":{"type":"integer","description":"Page number, default 1","example":1},"pageSize":{"type":"integer","description":"Results per page, min 10, max 100, default 100","example":10}},"required":["asin"],"example":{"asin":"B072MQ5BRX","pageSize":10,"desc":true,"pageNum":1,"country":"US"},"additionalProperties":true},"example":{"asin":"B072MQ5BRX","pageSize":10,"desc":true,"pageNum":1,"country":"US"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of data records actually returned","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Data array (see below)","example":[],"items":{"type":"object","properties":{"keyword":{"type":"string","description":"Keyword","example":"phone case"},"translateKeyword":{"type":"string","description":"Keyword translation, localized translation for the site","example":"phone case"},"asin":{"type":"string","description":"Product ASIN","example":"B072MQ5BRX"},"productNaturalRank":{"type":"integer","description":"Product natural search rank. The position ranking of this product in natural search results for this keyword, e.g. 1 means ranked 1st (top position) in search results","example":1},"naturalRankDisplay":{"type":"string","description":"Natural rank display text. String representation of natural search rank","example":null},"productAdRank":{"type":"integer","description":"Product SP ad rank. The ranking position of this product in Sponsored Products ad placements for this keyword, e.g. 3 means ranked 3rd in ad placement","example":1},"adRankDisplay":{"type":"string","description":"Ad rank display text. String representation of SP ad rank","example":null},"weeklySearchVolume":{"type":"integer","description":"Weekly search volume. Estimated weekly search count for this keyword on Amazon","example":1},"keywordPopularityRank":{"type":"integer","description":"Keyword search popularity rank. This keyword's monthly search volume ranking among all Amazon keywords; lower values indicate higher search volume","example":1},"totalSearchResultProductCount":{"type":"integer","description":"Total search result product count for this keyword (active listings)","example":1},"trafficShare":{"type":"number","description":"Traffic share. Proportion of traffic this keyword brings to the product out of all keywords' total traffic, where 1 = 100%","example":1},"naturalTrafficShare":{"type":"number","description":"Natural traffic score share. Natural search traffic score / total score","example":1},"paidTrafficShare":{"type":"number","description":"Paid ad traffic score share. Ad traffic score / total score; ad total = sp + sb + sbv + recAd","example":1},"naturalTrafficScore":{"type":"number","description":"Natural traffic score. Natural search exposure score this keyword brings to this ASIN; 0 = no natural traffic exposure","example":1},"sponsoredProductsScore":{"type":"number","description":"SP ad regular score. Traffic score for Sponsored Products regular placements (excluding SP recommendation placements)","example":1},"brandAdScore":{"type":"number","description":"SB brand ad score. Traffic score for Sponsored Brands brand ads (regular + video, combined)","example":1},"videoAdScore":{"type":"number","description":"SBV video ad score. Traffic score for Sponsored Brands Video video ads","example":1},"sponsoredRecommendationScore":{"type":"number","description":"SP recommendation placement score. Combined score for Trending now / Seen on social media / Customers frequently viewed / 4 stars and above, etc.","example":1},"sponsoredRecommendationBreakdown":{"type":"array","description":"SP recommendation placement score breakdown. Each entry {title, score, scoreRatio}","example":[]},"clickConcentrationShare":{"type":"number","description":"ABA TOP3 click concentration. Measures whether clicks are concentrated on top ASINs; note this is not conversion rate","example":1},"clickToPurchaseConversionRate":{"type":"number","description":"Click-to-purchase conversion rate (purchaseQty / clickQty)","example":1},"displayPositionTypes":{"type":"array","description":"Product display position type array. May contain: natural=natural search result position; ac=Amazon's Choice recommendation position; sp=Sponsored Products ad position; top=top-of-page brand ad position; bottom=bottom-of-page brand ad position; er=Editorial Recommendations position; vedio=video ad position; tr=Top Rated recommendation position; trfob=Top Rated Frequently Bought recommendation position","example":[]},"trafficCharacteristicMarkers":{"type":"array","description":"Keyword traffic characteristic marker array. May contain: isMainKw=main traffic keyword; isAccurateKw=precise traffic keyword; isAccurateAboveKw=precise broad keyword; isAccurateTailKw=precise long-tail keyword","example":[]},"conversionPerformanceMarkers":{"type":"array","description":"Conversion performance marker array. May contain: isPurchaseKw=converting keyword; isQualityKw=high-quality conversion keyword; isStableKw=stable conversion keyword; isLossKw=lost conversion keyword; isInvalidKw=invalid impression keyword","example":[]},"lastNaturalRankTime":{"type":"string","description":"Time of the most recent valid natural rank","example":null},"lastAdRankTime":{"type":"string","description":"Time of the most recent valid SP ad rank","example":null},"periodEndDate":{"type":"string","description":"Current period (weekly granularity) end date = start week + 7 days (site time)","example":"2026-01-01"},"updateTime":{"type":"string","description":"Keyword data update time","example":"2026-01-01"}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render columns","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Title","example":null},{"type":"null"}]},"isParentAsin":{"anyOf":[{"type":"boolean","description":"Whether it is a parent ASIN (pasin)","example":false},{"type":"null"}]},"hasVaiants":{"anyOf":[{"type":"boolean","description":"Whether it has variants","example":false},{"type":"null"}]},"abaCreateDateWeek":{"anyOf":[{"type":"string","description":"Week date corresponding to the latest weekly ABA data","example":"2026-01-01"},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Latency (ms)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"keyword":"phone case","translateKeyword":"phone case","asin":"B072MQ5BRX","productNaturalRank":1,"productAdRank":1,"weeklySearchVolume":1,"keywordPopularityRank":1,"totalSearchResultProductCount":1,"trafficShare":1,"naturalTrafficShare":1,"paidTrafficShare":1,"naturalTrafficScore":1,"sponsoredProductsScore":1,"brandAdScore":1,"videoAdScore":1,"sponsoredRecommendationScore":1,"sponsoredRecommendationBreakdown":[],"clickConcentrationShare":1,"clickToPurchaseConversionRate":1,"displayPositionTypes":[],"trafficCharacteristicMarkers":[],"conversionPerformanceMarkers":[],"periodEndDate":"2026-01-01","updateTime":"2026-01-01"}],"columns":[],"isParentAsin":false,"hasVaiants":false,"abaCreateDateWeek":"2026-01-01","costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-asin-keywords","x-nexscope-mcp-tool-name":"nexscope_amazon_asin_keywords","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-asin-traffic-summary/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Asin Traffic Summary","description":"Use Nexscope (Search Intelligence Framework) data to analyze ASIN traffic source composition and exposure distribution, covering current period/previous period/newly entered/exited period comparisons. Trigger when the user mentions ASIN traffic sources, traffic structure analysis, organic traffic vs paid traffic share, exposure score breakdown, period comparison, new/exited traffic keywords, competitor traffic analysis, SP ad keyword count, brand ad exposure, Amazon's Choice exposure, editorial recommendation exposure, Top Rated exposure, video ad exposure, organic search exposure ratio, PPC traffic sources, promotional deal traffic sources, recommendation slot structure breakdown, ASIN traffic analysis, traffic sources, organic traffic share, ad traffic share, exposure analysis, traffic structure, period-over-period comparison, keyword churn, Nexscope. Even if the user does not explicitly mention \"Nexscope\", if their need involves analyzing an ASIN's traffic sources, exposure channel distribution, cross-period comparison, or competitor traffic structure comparison, this skill should also be triggered.","operationId":"runAmazonAsinTrafficSummary","externalDocs":{"description":"Amazon Asin Traffic Summary documentation","url":"https://www.nexscope.ai/api-docs/amazon-asin-traffic-summary"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-asin-traffic-summary.","properties":{"searchValue":{"type":"string","description":"Search value, ASIN codes, comma-separated, max 10 ASINs, max length 1000 characters","example":"B072MQ5BRX"},"country":{"type":"string","description":"Country site, default US. Options (13 total): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA"},"last7d":{"type":"boolean","description":"Whether to get last 7 days data, default true. When false, use startDate/endDate range","example":false},"startDate":{"type":"string","description":"Start date yyyy-MM-dd (effective when last7d=false; if omitted, the latest system week is used)","example":"2025-03-01"},"endDate":{"type":"string","description":"End date yyyy-MM-dd (paired with startDate)","example":"2025-03-31"},"conditions":{"type":"string","description":"Condition filters, comma-separated. Options: nf (natural traffic), sp (SP ads), sb (SB regular), sbv (video ads), ad (ad traffic), acAd (SP recommendation), totalPeriod.in (new incoming traffic keywords)"},"sortBy":{"type":"string","description":"Sort field. Options: totalKeywordNum (all traffic keywords), naturalKeywordNum (natural traffic keywords), brandKeywordNum (brand ad keywords), vedioKeywordNum (video ad keywords), acKeywordNum (AC recommended keywords), erKeywordNum (ER recommended keywords), trKeywordNum (TR recommended keywords), sumScore (total keyword exposure score), totalNfScore (total natural rank exposure score), totalSpSocre (total SP ad exposure score, note spelling), totalBrandScore (total brand ad exposure score), totalVedioScore (total video ad exposure score), totalAcScore (total AC recommendation exposure score), totalTrScore (total TR recommendation exposure score), totalErScore (total ER recommendation exposure score)"},"pageNum":{"type":"integer","description":"Page number, default 1","example":1},"pageSize":{"type":"integer","description":"Results per page, min 10, max 10000, default 10000","example":10},"desc":{"type":"boolean","description":"Whether to sort descending, default true","example":false}},"required":["searchValue"],"example":{"last7d":true,"pageSize":10,"desc":true,"pageNum":1,"country":"US","searchValue":"B072MQ5BRX"},"additionalProperties":true},"example":{"last7d":true,"pageSize":10,"desc":true,"pageNum":1,"country":"US","searchValue":"B072MQ5BRX"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of data records actually returned","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Return data, ASIN summary object array (see below)","example":[],"items":{"type":"object","properties":{"asin":{"type":"string","description":"ASIN code. Amazon Standard Identification Number","example":"B072MQ5BRX"},"productTitle":{"type":"string","description":"Product title","example":null},"productCategory":{"type":"string","description":"Product category","example":null},"productPrice":{"type":"number","description":"Product price","example":1},"productImageUrl":{"type":"string","description":"Product main image URL","example":"https://example.com/image.jpg"},"productFeatures":{"type":"array","description":"Product feature list","example":[]},"customerRatingCount":{"type":"integer","description":"Total customer rating count","example":1},"productStarRating":{"type":"number","description":"Product star rating (0-5 stars)","example":1},"productRatingScore":{"type":"number","description":"Product rating score value (0-5, as displayed on Amazon page)","example":1},"isVariantProduct":{"type":"boolean","description":"Whether it is a variant","example":false},"recentMonthlySalesBucket":{"type":"string","description":"Recent month sales bucket (only has value in keywordSummary path, e.g. \"300+\" or \"1,000+\")","example":null},"isMonitored":{"type":"boolean","description":"Whether it is being monitored","example":false},"monitoringStartTime":{"type":"string","description":"Product monitoring start time","example":null},"dataPeriodStartDate":{"type":"string","description":"Data period start date (yyyy-MM-dd)","example":"2026-01-01"},"totalExposureScore":{"type":"number","description":"Total exposure score. Composite exposure score of this product across all keywords","example":1},"totalExposureScorePrev":{"type":"number","description":"Previous period total exposure score","example":1},"totalTrafficKeywordCount":{"type":"integer","description":"Total traffic keyword count","example":1},"totalTrafficKeywordCountIn":{"type":"integer","description":"New incoming traffic keyword count for this period","example":1},"totalTrafficKeywordCountOut":{"type":"integer","description":"Outgoing traffic keyword count for this period","example":1},"totalTrafficKeywordCountPrev":{"type":"integer","description":"Previous period total traffic keyword count","example":1},"naturalSearchExposureScore":{"type":"number","description":"Natural search exposure total score","example":1},"naturalSearchExposureRatio":{"type":"number","description":"Natural search exposure ratio","example":1},"naturalSearchExposureScorePrev":{"type":"number","description":"Previous period natural search exposure score","example":1},"naturalSearchKeywordCount":{"type":"integer","description":"Natural search keyword count","example":1},"naturalSearchKeywordCountIn":{"type":"integer","description":"New incoming natural search keyword count for this period","example":1},"naturalSearchKeywordCountOut":{"type":"integer","description":"Outgoing natural search keyword count for this period","example":1},"naturalSearchKeywordCountPrev":{"type":"integer","description":"Previous period natural search keyword count","example":1},"sponsoredProductsExposureScore":{"type":"number","description":"SP ad exposure total score","example":1},"sponsoredProductsExposureRatio":{"type":"number","description":"SP ad exposure ratio","example":1},"sponsoredProductsExposureScorePrev":{"type":"number","description":"Previous period SP ad exposure score","example":1},"sponsoredProductsKeywordCount":{"type":"integer","description":"SP ad keyword count","example":1},"brandAdExposureScore":{"type":"number","description":"Brand ad exposure total score","example":1},"brandAdExposureRatio":{"type":"number","description":"Brand ad exposure ratio","example":1},"brandAdExposureScorePrev":{"type":"number","description":"Previous period brand ad exposure score","example":1},"brandAdKeywordCount":{"type":"integer","description":"Total brand ad keyword count","example":1},"topBrandAdKeywordCount":{"type":"integer","description":"Top-of-page brand ad keyword count","example":1},"bottomBrandAdKeywordCount":{"type":"integer","description":"Bottom-of-page brand ad keyword count","example":1},"videoAdExposureScore":{"type":"number","description":"Video ad exposure total score","example":1},"videoAdExposureRatio":{"type":"number","description":"Video ad exposure ratio","example":1},"videoAdExposureScorePrev":{"type":"number","description":"Previous period video ad exposure score","example":1},"videoAdKeywordCount":{"type":"integer","description":"Video ad keyword count","example":1},"amazonsChoiceExposureScore":{"type":"number","description":"Amazon's Choice exposure total score","example":1},"amazonsChoiceExposureRatio":{"type":"number","description":"Amazon's Choice exposure ratio","example":1},"amazonsChoiceExposureScorePrev":{"type":"number","description":"Previous period AC exposure score","example":1},"amazonsChoiceKeywordCount":{"type":"integer","description":"Amazon's Choice keyword count","example":1},"amazonsChoiceKeywordCountIn":{"type":"integer","description":"New incoming AC keyword count for this period","example":1},"amazonsChoiceKeywordCountOut":{"type":"integer","description":"Outgoing AC keyword count for this period","example":1},"editorialRecommendationsExposureScore":{"type":"number","description":"Editorial Recommendations exposure total score","example":1},"editorialRecommendationsExposureRatio":{"type":"number","description":"Editorial Recommendations exposure ratio","example":1},"editorialRecommendationsKeywordCount":{"type":"integer","description":"Editorial Recommendations keyword count","example":1},"topRatedExposureScore":{"type":"number","description":"Top Rated recommendation exposure total score","example":1},"topRatedExposureRatio":{"type":"number","description":"Top Rated recommendation exposure ratio","example":1},"topRatedKeywordCount":{"type":"integer","description":"Top Rated recommendation keyword count","example":1},"frequentlyBoughtKeywordCount":{"type":"integer","description":"Frequently Bought recommendation keyword count (Top Rated Frequently Bought)","example":1},"recommendPositionExposureScore":{"type":"number","description":"Recommendation position exposure total score","example":1},"recommendAdExposureScore":{"type":"number","description":"Recommendation position ad exposure score","example":1},"recommendNonadExposureScore":{"type":"number","description":"Recommendation position non-ad exposure score","example":1},"nonAcRecommendExposureScore":{"type":"number","description":"Non-AC recommendation position exposure score","example":1},"recommendKeywordCount":{"type":"integer","description":"Total recommendation position keyword count","example":1},"recommendAdKeywordCount":{"type":"integer","description":"Recommendation position ad keyword count","example":1},"recommendNonadKeywordCount":{"type":"integer","description":"Recommendation position non-ad keyword count","example":1},"ppcTrafficSources":{"type":"array","description":"PPC paid ad traffic source markers. Contains: SP ads, top brand ads, bottom brand ads, video ads","example":[]},"naturalSearchTrafficSources":{"type":"array","description":"Natural search traffic source markers","example":[]},"amazonRecommendationSources":{"type":"array","description":"Amazon recommendation traffic source markers. Contains: Best Seller, AC, ER, TR, TRFOB, etc.","example":[]},"promotionalDealSources":{"type":"array","description":"Promotional deal traffic source markers. Contains: Coupon, Limited Time Deal, Lowest Price in 30 Days, etc.","example":[]}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render columns","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Title","example":null},{"type":"null"}]},"isParentAsin":{"anyOf":[{"type":"boolean","description":"Whether the search value is a parent ASIN","example":false},{"type":"null"}]},"variantsNum":{"anyOf":[{"type":"integer","description":"Number of variant products with keywords","example":1},{"type":"null"}]},"noKeywordVariantsNum":{"anyOf":[{"type":"integer","description":"Number of variant products without keywords","example":1},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Latency (ms)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"asin":"B072MQ5BRX","productPrice":1,"productImageUrl":"https://example.com/image.jpg","productFeatures":[],"customerRatingCount":1,"productStarRating":1,"productRatingScore":1,"isVariantProduct":false,"isMonitored":false,"dataPeriodStartDate":"2026-01-01","totalExposureScore":1,"totalExposureScorePrev":1,"totalTrafficKeywordCount":1,"totalTrafficKeywordCountIn":1,"totalTrafficKeywordCountOut":1,"totalTrafficKeywordCountPrev":1,"naturalSearchExposureScore":1,"naturalSearchExposureRatio":1,"naturalSearchExposureScorePrev":1,"naturalSearchKeywordCount":1,"naturalSearchKeywordCountIn":1,"naturalSearchKeywordCountOut":1,"naturalSearchKeywordCountPrev":1,"sponsoredProductsExposureScore":1,"sponsoredProductsExposureRatio":1,"sponsoredProductsExposureScorePrev":1,"sponsoredProductsKeywordCount":1,"brandAdExposureScore":1,"brandAdExposureRatio":1,"brandAdExposureScorePrev":1,"brandAdKeywordCount":1,"topBrandAdKeywordCount":1,"bottomBrandAdKeywordCount":1,"videoAdExposureScore":1,"videoAdExposureRatio":1,"videoAdExposureScorePrev":1,"videoAdKeywordCount":1,"amazonsChoiceExposureScore":1,"amazonsChoiceExposureRatio":1,"amazonsChoiceExposureScorePrev":1,"amazonsChoiceKeywordCount":1,"amazonsChoiceKeywordCountIn":1,"amazonsChoiceKeywordCountOut":1,"editorialRecommendationsExposureScore":1,"editorialRecommendationsExposureRatio":1,"editorialRecommendationsKeywordCount":1,"topRatedExposureScore":1,"topRatedExposureRatio":1,"topRatedKeywordCount":1,"frequentlyBoughtKeywordCount":1,"recommendPositionExposureScore":1,"recommendAdExposureScore":1,"recommendNonadExposureScore":1,"nonAcRecommendExposureScore":1,"recommendKeywordCount":1,"recommendAdKeywordCount":1,"recommendNonadKeywordCount":1,"ppcTrafficSources":[],"naturalSearchTrafficSources":[],"amazonRecommendationSources":[],"promotionalDealSources":[]}],"columns":[],"isParentAsin":false,"variantsNum":1,"noKeywordVariantsNum":1,"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-asin-traffic-summary","x-nexscope-mcp-tool-name":"nexscope_amazon_asin_traffic_summary","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-broad-product-search/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Broad Product Search","description":"Use Nexscope data to search and filter Amazon products, supporting multi-dimensional criteria including price, monthly sales, BSR ranking, gross margin, ratings, fulfillment method, badges, seller origin, and more across multiple Amazon marketplaces. Trigger when the user mentions Amazon product selection research, product filtering, sales filtering, product discovery, BSR analysis, niche product discovery, competitor analysis, market opportunity assessment, product-level market size estimation, gross margin screening, Nexscope product selection, Amazon product selection, sales filtering, BSR analysis, profit screening, market analysis, product selection tool. Even if the user does not explicitly mention \"Nexscope\", if their need involves filtering and analyzing Amazon product-level data for product selection, this skill should also be triggered.","operationId":"runAmazonBroadProductSearch","externalDocs":{"description":"Amazon Broad Product Search documentation","url":"https://www.nexscope.ai/api-docs/amazon-broad-product-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-broad-product-search.","properties":{"chatId":{"type":"string","description":"Chat ID, maxLength 1000","example":"example-id"},"uid":{"type":"string","description":"User ID, maxLength 1000","example":"example-id"},"requestId":{"type":"string","description":"Push ID, maxLength 1000","example":"example-id"},"teamId":{"type":"string","description":"Team ID, maxLength 1000","example":"example-id"},"keyword":{"type":"string","description":"Search keyword; translate to the corresponding country's language whenever possible, e.g. use English keywords for the US, German keywords for Germany, etc.; maxLength 10240","example":"phone case"},"matchType":{"type":"integer","description":"Match type: 1 = phrase match (default), 2 = fuzzy match, 3 = exact match","example":1},"excludeKeywords":{"type":"string","description":"Exclude keywords; maxLength 10240","example":"phone case"},"marketplace":{"type":"string","description":"Marketplace site code, default US. Only US, UK, DE, FR, JP, CA, IT, ES, MX, IN are allowed (must match this enum; AU, TR, and other unlisted sites are not supported)","example":"US"},"nodeLabel":{"type":"string","description":"Amazon category name; maxLength 1000"},"nodeIdPath":{"type":"string","description":"Amazon category node ID; maxLength 1000"},"filterSubNode":{"type":"boolean","description":"Whether to filter subcategory nodes; only effective when nodeLabel or nodeIdPath has a value; pass JSON boolean true / false","example":false},"dataSnapshotMonth":{"type":"string","description":"Product data snapshot month, format yyyyMM (e.g. 202412 for December 2024 data snapshot), or nearly for last 30 days real-time data. Default: nearly. Used for historical analysis and period comparison; only supports existing historical snapshots, future dates are not supported; maxLength 1000"},"minPrice":{"type":"number","description":"Minimum price (>= 0)","example":1},"maxPrice":{"type":"number","description":"Maximum price (>= 0)","example":1},"minProfit":{"type":"number","description":"Minimum gross margin, unit % (1-100)","example":1},"maxProfit":{"type":"number","description":"Maximum gross margin, unit % (1-100)","example":1},"minRevenue":{"type":"number","description":"Minimum monthly sales revenue (>= 0)","example":1},"maxRevenue":{"type":"number","description":"Maximum monthly sales revenue (>= 0)","example":1},"minFba":{"type":"number","description":"Minimum FBA shipping fee (>= 0)","example":1},"maxFba":{"type":"number","description":"Maximum FBA shipping fee (>= 0)","example":1},"minUnits":{"type":"integer","description":"Minimum monthly sales volume (>= 0)","example":1},"maxUnits":{"type":"integer","description":"Maximum monthly sales volume (>= 0)","example":1},"minAmzUnit":{"type":"integer","description":"Minimum variant last-30-day sales volume (only supported when dataSnapshotMonth is a \"last 30 days\" type query); minimum 0","example":1},"maxAmzUnit":{"type":"integer","description":"Maximum variant last-30-day sales volume (only supported for last 30 days queries); minimum 0","example":1},"minUnitsGrowthRate":{"type":"number","description":"Minimum monthly sales volume growth rate, unit %","example":1},"maxUnitsGrowthRate":{"type":"number","description":"Maximum monthly sales volume growth rate, unit %","example":1},"minBsr":{"type":"integer","description":"Lowest main category BSR rank","example":1},"maxBsr":{"type":"integer","description":"Highest main category BSR rank","example":1},"minBsrGrowthRate":{"type":"number","description":"Minimum BSR growth rate, unit %","example":1},"maxBsrGrowthRate":{"type":"number","description":"Maximum BSR growth rate, unit %","example":1},"minBsrGrowthCount":{"type":"integer","description":"Minimum BSR growth count","example":1},"maxBsrGrowthCount":{"type":"integer","description":"Maximum main category BSR growth count","example":1},"minSubNodeBsrRank":{"type":"integer","description":"Lowest subcategory BSR rank (requires filterSubNode = true)","example":1},"maxSubNodeBsrRank":{"type":"integer","description":"Highest subcategory BSR rank (requires filterSubNode = true)","example":1},"minRating":{"type":"number","description":"Minimum rating value (0-5)","example":1},"maxRating":{"type":"number","description":"Maximum rating value (0-5), 3.8-4.3 is the product improvement opportunity range","example":1},"minRatings":{"type":"integer","description":"Minimum review count (0-10000)","example":1},"maxRatings":{"type":"integer","description":"Maximum review count (0-10000)","example":1},"minRatingsGrowthCount":{"type":"integer","description":"Minimum monthly new review count (>= 0)","example":1},"maxRatingsGrowthCount":{"type":"integer","description":"Maximum monthly new review count (>= 0)","example":1},"minListingQualityScore":{"type":"number","description":"Minimum Listing page quality score (>= 0)","example":1},"maxListingQualityScore":{"type":"number","description":"Maximum Listing page quality score (>= 0)","example":1},"minVariations":{"type":"integer","description":"Minimum number of variations","example":1},"maxVariations":{"type":"integer","description":"Maximum number of variations","example":1},"minWeights":{"type":"number","description":"Minimum weight (>= 0)","example":1},"maxWeights":{"type":"number","description":"Maximum weight (>= 0)","example":1},"weightUnit":{"type":"string","description":"Weight unit: g, kg, oz, lb. This field must be specified if the parameters include weight filtering"},"dimensionType":{"type":"string","description":"Package dimension type (codes vary by site, see below)"},"minSellers":{"type":"integer","description":"Minimum number of sellers","example":1},"maxSellers":{"type":"integer","description":"Maximum number of sellers","example":1},"badgeBestSeller":{"type":"string","description":"Best Seller badge filter: Y, N, or empty (all)"},"badgeAmazonsChoice":{"type":"string","description":"Amazon's Choice badge filter: Y, N, or empty (all)"},"badgeNewRelease":{"type":"string","description":"New Release badge filter: Y, N, or empty (all)"},"fulfillment":{"type":"string","description":"Fulfillment method: single select AMZ / FBA / FBM, or multi-select such as AMZ,FBA, FBA,FBM, AMZ,FBA,FBM, etc.; multiple conditions use comma separation; empty means no limit"},"showVariation":{"type":"string","description":"Whether to query variants: Y or N, default N"},"hideUnlistedProduct":{"type":"boolean","description":"Whether to hide delisted products, default true","example":false},"listedWithinLastMonths":{"type":"integer","description":"Time since listing (months), only allowed: 1, 3, 6, 12, 24 (must match these enum values; do not pass other integers)","example":1},"sellerNation":{"type":"string","description":"Seller location code (e.g. US, CN, HK), multiple conditions comma-separated, default no limit"},"includeSellers":{"type":"string","description":"Include sellers; maxLength 10240"},"excludeSellers":{"type":"string","description":"Exclude sellers; maxLength 10240"},"includeBrands":{"type":"string","description":"Include brands; maxLength 10240"},"excludeBrands":{"type":"string","description":"Exclude brands; maxLength 10240"},"order":{"type":"object","description":"Sort configuration; if passed, it is recommended to provide both field and desc (both are required in the sub-schema)","example":{},"properties":{"field":{"type":"string","description":"Sort field: total_units (monthly sales), total_amount (monthly revenue), bsr_rank, price, rating, reviews, profit, reviews_rate, available_date, questions, total_units_growth, total_amount_growth, reviews_increasement, bsr_rank_cv, bsr_rank_cr, amz_unit (variant sales). Default total_units. Pass an empty string \"\" to not sort by the above business fields (full query sort semantics are handled by the server)"},"desc":{"type":"string","description":"\"true\" descending, \"false\" ascending; default \"true\"; maxLength 1000"}},"additionalProperties":true},"page":{"type":"integer","description":"Page number, starting from 1, default 1","example":1},"size":{"type":"integer","description":"Results per page (10-100), default 20","example":20}},"example":{"marketplace":"US","matchType":1,"keyword":"phone case","size":20,"page":1},"additionalProperties":true},"example":{"marketplace":"US","matchType":1,"keyword":"phone case","size":20,"page":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total matching product count","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list (see product object fields below)","example":[],"items":{"type":"object","properties":{"nodeIdPath":{"type":"string","description":"Node ID path","example":null},"nodeLabel":{"type":"string","description":"Amazon category name","example":null},"asin":{"type":"string","description":"Amazon ASIN","example":"B072MQ5BRX"},"title":{"type":"string","description":"Product title","example":null},"asinUrl":{"type":"string","description":"Amazon product detail page URL","example":"B072MQ5BRX"},"imageUrl":{"type":"string","description":"Product image URL","example":"https://example.com/image.jpg"},"price":{"type":"number","description":"Current price","example":1},"averagePrice":{"type":"number","description":"Average price","example":1},"primePrice":{"type":"number","description":"Prime price, -1 means not available","example":1},"currency":{"type":"string","description":"Currency","example":null},"monthlySalesUnits":{"type":"integer","description":"Monthly sales volume","example":1},"monthlySalesRevenue":{"type":"number","description":"Monthly sales revenue","example":1},"monthlySalesUnitsGrowthRate":{"type":"number","description":"Monthly sales volume growth rate","example":1},"bsr":{"type":"integer","description":"BSR rank","example":1},"bsrGrowthRate":{"type":"number","description":"BSR growth rate","example":1},"rating":{"type":"number","description":"Rating","example":1},"ratings":{"type":"integer","description":"Review count","example":1},"ratingsRate":{"type":"number","description":"Review rate","example":1},"profit":{"type":"number","description":"Gross margin (%)","example":1},"fba":{"type":"number","description":"FBA shipping fee","example":1},"sellerNum":{"type":"integer","description":"Number of sellers","example":1},"sellerId":{"type":"string","description":"BuyBox seller ID","example":"example-id"},"sellerName":{"type":"string","description":"BuyBox seller name","example":null},"sellerNation":{"type":"string","description":"BuyBox seller nationality","example":null},"brand":{"type":"string","description":"Brand","example":null},"brandUrl":{"type":"string","description":"Brand page URL","example":"https://example.com/image.jpg"},"fulfillment":{"type":"string","description":"Fulfillment method (AMZ / FBA / FBM)","example":null},"availableDate":{"type":"string","description":"Listing time (timestamp)","example":"2026-01-01"},"availableDateString":{"type":"string","description":"Listing date (formatted string)","example":"2026-01-01"},"variationNum":{"type":"integer","description":"Number of variations","example":1},"variant30DayUnits":{"type":"integer","description":"Variant monthly sales (units)","example":1},"variant30DayRevenue":{"type":"number","description":"Variant monthly sales revenue (amount)","example":1},"variant30DayUpdatedAt":{"type":"string","description":"Variant data update time","example":"2026-01-01"},"weight":{"type":"string","description":"Weight","example":null},"packageWeight":{"type":"string","description":"Package weight","example":null},"dimension":{"type":"string","description":"Dimensions","example":null},"packageDimensions":{"type":"string","description":"Package dimensions","example":null},"dimensionsType":{"type":"string","description":"Dimension type","example":null},"packageDimensionType":{"type":"string","description":"Package dimension type","example":null},"listingQualityScore":{"type":"number","description":"Listing quality score","example":1},"deliveryPrice":{"type":"number","description":"Seller shipping fee, -1 means not available","example":1},"nodeLabelPath":{"type":"string","description":"Category path","example":null},"nodeId":{"type":"integer","description":"Node ID","example":1},"dataSnapshotMonth":{"type":"string","description":"Data query month","example":null},"badgeBestSeller":{"type":"string","description":"Best Seller badge (Y/N)","example":null},"badgeAmazonChoice":{"type":"string","description":"Amazon's Choice badge (Y/N)","example":null},"badgeNewRelease":{"type":"string","description":"New Release badge (Y/N)","example":null},"badgeVideo":{"type":"string","description":"Video introduction (Y/N)","example":null},"badgeEbc":{"type":"string","description":"A+ page (Y/N)","example":null},"badge":{"type":"object","description":"Badge summary object, containing: bestSeller, amazonChoice, newRelease, video, ebc","example":{}},"subcategories":{"type":"array","description":"Subcategory list, each entry containing code (category code), rank (rank), label (name)","example":[]},"sku":{"type":"string","description":"SKU","example":null},"keyword":{"type":"string","description":"Matching keyword","example":"phone case"},"sourceType":{"type":"string","description":"Source type","example":null},"sourceTool":{"type":"string","description":"Source tool identifier","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render column definitions","example":[]},{"type":"null"}]},"keyword":{"anyOf":[{"type":"string","description":"Search keyword used (if any)","example":"phone case"},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data query month","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type (e.g. \"amazon\")","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"asin":"B072MQ5BRX","asinUrl":"B072MQ5BRX","imageUrl":"https://example.com/image.jpg","price":1,"averagePrice":1,"primePrice":1,"monthlySalesUnits":1,"monthlySalesRevenue":1,"monthlySalesUnitsGrowthRate":1,"bsr":1,"bsrGrowthRate":1,"rating":1,"ratings":1,"ratingsRate":1,"profit":1,"fba":1,"sellerNum":1,"sellerId":"example-id","brandUrl":"https://example.com/image.jpg","availableDate":"2026-01-01","availableDateString":"2026-01-01","variationNum":1,"variant30DayUnits":1,"variant30DayRevenue":1,"variant30DayUpdatedAt":"2026-01-01","listingQualityScore":1,"deliveryPrice":1,"nodeId":1,"badge":{},"subcategories":[],"keyword":"phone case"}],"columns":[],"keyword":"phone case","costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-broad-product-search","x-nexscope-mcp-tool-name":"nexscope_amazon_broad_product_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-category-lookup/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Category Lookup","description":"Supports exact parent-node browsing and label-based category search.","operationId":"runAmazonCategoryLookup","externalDocs":{"description":"Amazon Category Lookup documentation","url":"https://www.nexscope.ai/api-docs/amazon-category-lookup"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Use lookup to browse nodes. Use like with nodeLabel to search category names.","properties":{"operation":{"type":"string","description":"lookup (default) or like.","example":"lookup"},"marketId":{"type":"string","description":"Amazon marketplace or site identifier.","example":"1"},"nodeId":{"type":"string","description":"Parent category node identifier.","example":"0"},"table":{"type":"string","description":"Optional upstream category table selector.","example":"nodes"},"nodeLabel":{"type":"string","description":"Category label required by operation=like.","example":"Electronics"}},"example":{"marketId":"1","operation":"lookup","nodeId":"0"},"additionalProperties":true},"example":{"marketId":"1","operation":"lookup","nodeId":"0"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of returned category nodes.","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Amazon category node records.","example":[],"items":{"type":"object","properties":{"nodeId":{"type":"string","description":"Category node identifier.","example":"172282"},"nodeLabel":{"type":"string","description":"Category label.","example":"Electronics"},"parentNodeId":{"type":"string","description":"Parent node identifier.","example":"0"}}}},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Provider-reported token cost.","example":150},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"nodeId":"172282","nodeLabel":"Electronics","parentNodeId":"0"}],"costToken":150},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-category-lookup","x-nexscope-mcp-tool-name":"nexscope_amazon_category_lookup","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-competitor-lookup/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Competitor Lookup","description":"Use Nexscope data to find and analyze competitors on Amazon, covering 12 marketplaces, with product metrics including sales, BSR, pricing, ratings, and growth trends. Trigger when the user mentions competitor lookup, competitor analysis, ASIN reverse lookup, competitive product research, finding similar products, market competitor discovery, product benchmarking, competitor sales estimation, analyzing competitor listings, competitor analysis, ASIN reverse lookup, competitor sales, competitor research, Nexscope, market competitor discovery, competitor trends. Even if the user does not explicitly mention \"Nexscope\" or \"competitor lookup\", if their need involves discovering and analyzing Amazon competitors by ASIN, keyword, seller name, brand, or category, this skill should also be triggered.","operationId":"runAmazonCompetitorLookup","externalDocs":{"description":"Amazon Competitor Lookup documentation","url":"https://www.nexscope.ai/api-docs/amazon-competitor-lookup"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-competitor-lookup.","properties":{"marketplace":{"type":"string","description":"Amazon site code, default US. Options: US, UK, DE, FR, JP, CA, IT, ES, MX, AU, TR, IN","example":"US"},"keyword":{"type":"string","description":"Search keyword. Translate to the corresponding country's language whenever possible, e.g. use English keywords for the US, German keywords for Germany, etc.","example":"phone case"},"asinList":{"type":"string","description":"ASINs, multiple ASINs comma-separated, max 40. Format: ^[A-Z0-9]+(,[A-Z0-9]+){0,39}$","example":"B072MQ5BRX"},"sellerName":{"type":"string","description":"Seller name filter"},"brand":{"type":"string","description":"Brand name filter"},"nodeLabel":{"type":"string","description":"Amazon category name, supports multi-level category names, levels separated by colon :, e.g. Electronics:Headphones"},"nodeIdPath":{"type":"string","description":"Amazon category ID path"},"matchType":{"type":"integer","description":"Match type. 1 = phrase match (default), 2 = fuzzy match, 3 = exact match","example":1},"showVariation":{"type":"string","description":"Whether to query variants. Y = yes, N = no (default)"},"dataSnapshotMonth":{"type":"string","description":"Amazon product data snapshot month. Default nearly (queries last 30 days real-time data). Use yyyyMM format to query historical snapshots (e.g. 202412 for December 2024). Only supports existing historical snapshots, future dates are not supported. Recommended for seasonal analysis to query the same period last year's snapshot for comparison"},"page":{"type":"integer","description":"Page number, starting from 1 (default 1)","example":1},"size":{"type":"integer","description":"Results per page, returns 10-100 records (default 50)","example":10},"order":{"type":"object","description":"Sort configuration (see below)","example":{},"properties":{},"additionalProperties":true}},"example":{"page":1,"keyword":"phone case","marketplace":"US","size":10,"matchType":1,"asinList":"B072MQ5BRX"},"additionalProperties":true},"example":{"page":1,"keyword":"phone case","marketplace":"US","size":10,"matchType":1,"asinList":"B072MQ5BRX"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total matching result count","example":1},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type (e.g. amazon)","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render column definitions","example":[]},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Competitor list (see below)","example":[],"items":{"type":"object","properties":{"nodeLabel":{"anyOf":[{"type":"string","description":"Category name echo","example":null},{"type":"null"}]},"asin":{"type":"string","description":"Product ASIN","example":"B072MQ5BRX"},"title":{"type":"string","description":"Product title","example":null},"price":{"type":"number","description":"Current price","example":1},"primePrice":{"type":"number","description":"Prime price","example":1},"averagePrice":{"type":"number","description":"Average price","example":1},"currency":{"type":"string","description":"Currency","example":null},"monthlySalesUnits":{"type":"integer","description":"Monthly sales volume (units)","example":1},"monthlySalesRevenue":{"type":"number","description":"Monthly sales revenue","example":1},"monthlySalesUnitsGrowthRate":{"type":"number","description":"Monthly sales volume growth rate","example":1},"bsr":{"type":"integer","description":"BSR rank","example":1},"bsrGrowthRate":{"type":"number","description":"BSR growth rate","example":1},"bsrGrowthCount":{"type":"integer","description":"BSR growth count","example":1},"rating":{"type":"number","description":"Rating","example":1},"ratings":{"type":"integer","description":"Review count","example":1},"ratingsGrowth":{"type":"integer","description":"Monthly new review count","example":1},"ratingsRate":{"type":"number","description":"Review rate","example":1},"brand":{"type":"string","description":"Brand","example":null},"brandUrl":{"type":"string","description":"Brand URL","example":"https://example.com/image.jpg"},"sellerName":{"type":"string","description":"BuyBox seller name","example":null},"sellerId":{"type":"string","description":"BuyBox seller ID","example":"example-id"},"sellerNation":{"type":"string","description":"BuyBox seller nationality","example":null},"sellerNum":{"type":"integer","description":"Number of sellers","example":1},"fulfillment":{"type":"string","description":"Fulfillment method: AMZ, FBA, FBM","example":null},"availableDate":{"type":"string","description":"Listing time (date format)","example":"2026-01-01"},"availableDateString":{"type":"string","description":"Listing date (string format)","example":"2026-01-01"},"profit":{"type":"number","description":"Gross margin","example":1},"fba":{"type":"number","description":"FBA shipping fee","example":1},"deliveryPrice":{"type":"number","description":"Seller shipping fee","example":1},"imageUrl":{"type":"string","description":"Product image URL","example":"https://example.com/image.jpg"},"parent":{"type":"string","description":"Parent ASIN","example":null},"variationNum":{"type":"integer","description":"Number of variations","example":1},"variant30DayUnits":{"type":"integer","description":"Variant monthly sales (units)","example":1},"variant30DayRevenue":{"type":"number","description":"Variant monthly sales revenue","example":1},"variant30DayUpdatedAt":{"type":"string","description":"Variant data update time (timestamp)","example":"2026-01-01"},"amzUnitDateString":{"type":"string","description":"Variant sales update date","example":"2026-01-01"},"listingQualityScore":{"type":"number","description":"Listing quality score","example":1},"nodeLabelPath":{"type":"string","description":"Category path","example":null},"nodeIdPath":{"type":"string","description":"Node ID path","example":null},"nodeId":{"type":"integer","description":"Node ID","example":1},"dimension":{"type":"string","description":"Product dimensions","example":null},"dimensionsType":{"type":"string","description":"Dimension type","example":null},"weight":{"type":"string","description":"Product weight","example":null},"packageDimensions":{"type":"string","description":"Package dimensions","example":null},"packageDimensionType":{"type":"string","description":"Package dimension type","example":null},"packageWeight":{"type":"string","description":"Package weight","example":null},"sku":{"type":"string","description":"SKU","example":null},"keyword":{"type":"string","description":"Matching keyword (if searched by keyword, displays the corresponding keyword)","example":"phone case"},"dataSnapshotMonth":{"type":"string","description":"Data query month","example":null},"sourceTool":{"type":"string","description":"Source tool","example":null},"sourceType":{"type":"string","description":"Source type","example":null},"badgeBestSeller":{"type":"string","description":"Best Seller badge (Y/N)","example":null},"badgeAmazonChoice":{"type":"string","description":"Amazon's Choice badge (Y/N)","example":null},"badgeNewRelease":{"type":"string","description":"New Release badge (Y/N)","example":null},"badgeEbc":{"type":"string","description":"A+ page (Y/N)","example":null},"badgeVideo":{"type":"string","description":"Video introduction (Y/N)","example":null},"badge":{"type":"object","description":"Badge detail object, containing: bestSeller, amazonChoice, newRelease, ebc, video (all Y/N strings)","example":{}},"subcategories":{"type":"array","description":"Subcategory rankings, each entry containing code (category code), rank (rank), label (name)","example":[]}}}},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"columns":[],"products":[{"asin":"B072MQ5BRX","price":1,"primePrice":1,"averagePrice":1,"monthlySalesUnits":1,"monthlySalesRevenue":1,"monthlySalesUnitsGrowthRate":1,"bsr":1,"bsrGrowthRate":1,"bsrGrowthCount":1,"rating":1,"ratings":1,"ratingsGrowth":1,"ratingsRate":1,"brandUrl":"https://example.com/image.jpg","sellerId":"example-id","sellerNum":1,"availableDate":"2026-01-01","availableDateString":"2026-01-01","profit":1,"fba":1,"deliveryPrice":1,"imageUrl":"https://example.com/image.jpg","variationNum":1,"variant30DayUnits":1,"variant30DayRevenue":1,"variant30DayUpdatedAt":"2026-01-01","amzUnitDateString":"2026-01-01","listingQualityScore":1,"nodeId":1,"keyword":"phone case","badge":{},"subcategories":[]}],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-competitor-lookup","x-nexscope-mcp-tool-name":"nexscope_amazon_competitor_lookup","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-keyword-expansion/run":{"post":{"tags":["Keyword & Search Demand"],"summary":"Amazon Keyword Expansion","description":"Nexscope keyword expansion tool that expands a seed keyword into a list of related keywords with search volume, trends, PPC bids, ranking difficulty, and other metrics, covering 10 Amazon marketplaces including US, UK, DE, JP, etc. Trigger when the user mentions keyword expansion, keyword mining, long-tail keyword mining, related keywords, keyword suggestions, keyword discovery, PPC bid research, keyword competition, keyword discovery, Nexscope keywords, keyword expansion, keyword discovery, keyword scout, related keywords, long-tail keywords, keyword suggestions, PPC bid research, keyword competition, seed keyword expansion, keyword mining. Even if the user does not explicitly mention \"Nexscope\", if their need involves finding more related keywords and their search volume, competition, and other metrics starting from a seed keyword, this skill should also be triggered.","operationId":"runAmazonKeywordExpansion","externalDocs":{"description":"Amazon Keyword Expansion documentation","url":"https://www.nexscope.ai/api-docs/amazon-keyword-expansion"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-keyword-expansion.","properties":{"marketplace":{"type":"string","description":"Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp. Default us","example":"us"},"searchTerms":{"type":"string","description":"Seed keyword (single keyword string)","example":"phone case"},"needCount":{"type":"integer","description":"Total number of results returned","example":10},"sort":{"type":"string","description":"Sort field, default -monthly_search_volume_exact (exact search volume descending)"},"minMonthlySearchVolumeExact":{"type":"integer","description":"Minimum exact search volume","example":1},"maxMonthlySearchVolumeExact":{"type":"integer","description":"Maximum exact search volume","example":1},"minMonthlySearchVolumeBroad":{"type":"integer","description":"Minimum broad search volume","example":1},"maxMonthlySearchVolumeBroad":{"type":"integer","description":"Maximum broad search volume","example":1},"minWordCount":{"type":"integer","description":"Minimum word count for keywords (for filtering long-tail keywords)","example":1},"maxWordCount":{"type":"integer","description":"Maximum word count for keywords","example":1},"minOrganicProductCount":{"type":"integer","description":"Minimum organic product count","example":1},"maxOrganicProductCount":{"type":"integer","description":"Maximum organic product count","example":1}},"required":["marketplace","searchTerms"],"example":{"needCount":10,"searchTerms":"phone case","marketplace":"us"},"additionalProperties":true},"example":{"needCount":10,"searchTerms":"phone case","marketplace":"us"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"keywordInfoList":{"anyOf":[{"type":"array","description":"Keyword information list","example":[],"items":{"type":"object","properties":{"name":{"type":"string","description":"Keyword name","example":null},"country":{"type":"string","description":"Marketplace code","example":null},"monthlySearchVolumeExact":{"type":"integer","description":"Monthly average exact match search volume","example":1},"monthlySearchVolumeBroad":{"type":"integer","description":"Monthly average broad match search volume","example":1},"monthlyTrend":{"type":"number","description":"Monthly search volume change percentage","example":1},"quarterlyTrend":{"type":"number","description":"Quarterly search volume change percentage","example":1},"dominantCategory":{"type":"string","description":"Category with the highest share in search results","example":null},"relevancyScore":{"type":"integer","description":"Relative relevance score to the seed keyword. Higher values indicate a closer match; the upstream provider does not document a fixed 0-100 range","example":1},"easeOfRankingScore":{"type":"integer","description":"Ease of ranking score (higher means easier to rank)","example":1},"organicProductCount":{"type":"integer","description":"Number of organic ranking products","example":1},"sponsoredProductCount":{"type":"integer","description":"Number of sponsored products","example":1},"ppcBidExact":{"type":"number","description":"Exact match PPC suggested bid (USD)","example":1},"ppcBidBroad":{"type":"number","description":"Broad match PPC suggested bid (USD)","example":1},"spBrandAdBid":{"type":"number","description":"Sponsored Brand ad suggested bid (USD)","example":1},"recommendedPromotions":{"type":"integer","description":"Number of recommended promotion giveaways","example":1}}}},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"costToken":1,"keywordInfoList":[{"monthlySearchVolumeExact":1,"monthlySearchVolumeBroad":1,"monthlyTrend":1,"quarterlyTrend":1,"relevancyScore":1,"easeOfRankingScore":1,"organicProductCount":1,"sponsoredProductCount":1,"ppcBidExact":1,"ppcBidBroad":1,"spBrandAdBid":1,"recommendedPromotions":1}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-keyword-expansion","x-nexscope-mcp-tool-name":"nexscope_amazon_keyword_expansion","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-keyword-intelligence/run":{"post":{"tags":["Keyword & Search Demand"],"summary":"Amazon Keyword Intelligence","description":"Query and analyze Amazon ABA (Brand Analytics) search term data, covering 15 marketplaces with nearly 3 years of weekly data. Trigger when the user mentions ABA data, Amazon search term analysis, keyword mining, search ranking trends, market opportunity analysis, seasonal keywords, high-click low-conversion analysis, blue ocean keyword discovery, competitor keyword analysis, ABA data, search term report, keyword mining, search ranking trends, blue ocean keywords, click share, conversion share, seasonal keywords, market opportunity analysis, competitor keywords. Even if the user does not explicitly mention \"ABA\", if their need involves Amazon search term data and ranking analysis, this skill should also be triggered.","operationId":"runAmazonKeywordIntelligence","externalDocs":{"description":"Amazon Keyword Intelligence documentation","url":"https://www.nexscope.ai/api-docs/amazon-keyword-intelligence"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-keyword-intelligence.","properties":{"analysisDescription":{"type":"string","description":"Natural language description that precisely expresses the query intent","example":"Analyze Amazon Brand Analytics search demand for phone case in the US marketplace"},"region":{"type":"string","description":"Site code, default US. Options: US, DE, BR, CA, AU, JP, AE, ES, FR, IT, SA, TR, MX, SE, NL","example":"US"},"createDownloadUrl":{"type":"boolean","description":"Whether to generate a CSV download link, default false","example":false}},"required":["analysisDescription"],"example":{"region":"US","createDownloadUrl":false,"analysisDescription":"Find Amazon Brand Analytics search demand for phone case in the US marketplace"},"additionalProperties":true},"example":{"region":"US","createDownloadUrl":false,"analysisDescription":"Find Amazon Brand Analytics search demand for phone case in the US marketplace"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the query succeeded","example":false},{"type":"null"}]},"tables":{"anyOf":[{"type":"array","description":"Result data array, each element containing data (data rows), columns (column definitions), name (Sheet name)","example":[],"items":{"type":"object","properties":{"data":{"type":"array","description":"Query result rows; actual columns vary with the query","example":[],"items":{"type":"object","properties":{"searchTerm":{"type":"string","description":"Consumer search term","example":null},"reportStartDate":{"type":"string","description":"Start date of the reporting week","example":null},"region":{"type":"string","description":"Amazon marketplace code","example":null},"searchFrequencyRank":{"type":"integer","description":"Search frequency rank; lower values indicate higher popularity","example":null},"clickedAsin":{"type":"string","description":"ASIN of the clicked product","example":null},"clickedItemName":{"type":"string","description":"Name of the clicked product","example":null},"clickShareRank":{"type":"integer","description":"Click share rank of this ASIN for the search term","example":null},"clickShare":{"type":"number","description":"Click share for this ASIN, from 0 to 1","example":null},"conversionShare":{"type":"number","description":"Conversion share for this ASIN, from 0 to 1","example":null}}}},"columns":{"type":"array","description":"Result column definitions","example":[]},"name":{"type":"string","description":"Sheet name","example":null}}}},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"Total result count","example":1},{"type":"null"}]},"downloadUrl":{"anyOf":[{"type":"string","description":"When createDownloadUrl is true, returns the CSV file URL","example":"https://example.com/image.jpg"},{"type":"null"}]},"downloadNote":{"anyOf":[{"type":"string","description":"Download-related note","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Latency (ms)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"success":false,"tables":[{"data":[],"columns":[]}],"total":1,"downloadUrl":"https://example.com/image.jpg","costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-keyword-intelligence","x-nexscope-mcp-tool-name":"nexscope_amazon_keyword_intelligence","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-keyword-overview/run":{"post":{"tags":["Keyword & Search Demand"],"summary":"Amazon Keyword Overview","description":"Nexscope overview analysis of Amazon keyword market competition. Trigger when the user mentions keyword competition, supply-demand ratio, competitor count, keyword search volume estimation, market competitiveness assessment, keyword popularity ranking, ad competition analysis, number of products under a keyword, keyword competition, supply-demand ratio, competitor count, search popularity, market competition analysis, Nexscope, keyword overview. Even if the user does not explicitly say \"Nexscope\", if their need involves assessing keyword-level competition intensity, supply-demand balance, or search result product count on Amazon, this skill should also be triggered.","operationId":"runAmazonKeywordOverview","externalDocs":{"description":"Amazon Keyword Overview documentation","url":"https://www.nexscope.ai/api-docs/amazon-keyword-overview"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-keyword-overview.","properties":{"keyword":{"type":"string","description":"Keyword, translate to the corresponding country's language whenever possible. Max length: 1000 characters","example":"phone case"},"country":{"type":"string","description":"Country site, default US. Options (13 total): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA"},"last7d":{"type":"boolean","description":"Whether to get last 7 days data, default true. When false, use startDate/endDate range","example":true},"startDate":{"type":"string","description":"Start date yyyy-MM-dd (effective when last7d=false)","example":"2026-01-01"},"endDate":{"type":"string","description":"End date yyyy-MM-dd (paired with startDate)","example":"2026-01-01"}},"required":["keyword"],"example":{"last7d":true,"keyword":"phone case","country":"US"},"additionalProperties":true},"example":{"last7d":true,"keyword":"phone case","country":"US"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total data count. Note: this endpoint typically returns only a single record, total is usually 1","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Return data (see data fields below)","example":[],"items":{"type":"object","properties":{"keyword":{"type":"string","description":"Keyword. The keyword text of the search query","example":"phone case"},"keywordPopularityRank":{"type":"integer","description":"Keyword popularity rank. This keyword's monthly search volume ranking among all Amazon keywords; lower values indicate higher search volume","example":1},"estimatedWeeklySearchVolume":{"type":"integer","description":"Estimated weekly search volume. Estimated weekly search count for this keyword on Amazon, reflecting its search popularity","example":1},"supplyDemandRatio":{"type":"number","description":"Supply-demand ratio. Ratio of supply to demand, formula: search result product count / monthly search volume; lower values indicate less competition and greater opportunity","example":1},"totalSearchResultProductCount":{"type":"integer","description":"Total search result product count. Total number of products displayed for this keyword (including natural search, ad placements, recommendation placements, etc.)","example":1},"naturalSearchProductCount":{"type":"integer","description":"Natural search product count. Number of products displayed in natural search results for this keyword (excluding ad placements)","example":1},"sponsoredProductsCount":{"type":"integer","description":"SP ad product count. Number of products running Sponsored Products ads for this keyword","example":1},"brandAdProductCount":{"type":"integer","description":"Brand ad product count. Number of products running brand ads for this keyword","example":1},"videoAdProductCount":{"type":"integer","description":"Video ad product count. Number of products running video ads for this keyword","example":1},"paidAdvertisingProductCount":{"type":"integer","description":"Total PPC ad product count. Total number of products running any PPC paid ads for this keyword (including SP, brand ads, video ads, etc.)","example":1},"amazonChoiceProductCount":{"type":"integer","description":"Amazon's Choice product count. Number of products with the Amazon's Choice badge for this keyword","example":1},"topRatedProductCount":{"type":"integer","description":"Top Rated recommended product count. Number of products appearing in the Top Rated (high rating) recommendation placement for this keyword","example":1},"searchRecommendationProductCount":{"type":"integer","description":"Search recommendation product count. Number of products recommended by Amazon when searching this keyword","example":1},"editorialRecommendationsProductCount":{"type":"integer","description":"Editorial Recommendations product count. Number of products appearing in the editorial recommendation placement for this keyword","example":1},"recNonadProductCount":{"type":"integer","description":"Recommendation placement non-ad product count. Number of non-ad (organic) products in recommendation placements for this keyword","example":1},"recAdProductCount":{"type":"integer","description":"Recommendation placement ad product count. Number of ad products in recommendation placements for this keyword","example":1},"trackedAsinTotalCount":{"type":"integer","description":"Nexscope tracked ASIN deduplicated total count. Deduplicated count of ASINs that Nexscope has tracked with exposure scores across all positions (natural/ad/recommendation) for this keyword (upstream field: totalAsinNum)","example":1},"totalMarketplaceKeywordCount":{"type":"integer","description":"Total marketplace keyword count. Total number of keywords for this site, used to understand overall market size","example":1},"dataPeriodStartDate":{"type":"string","description":"Data period start date. ABA week start date corresponding to the returned data (yyyy-MM-dd)","example":"2026-01-01"},"dataPeriodEndDate":{"type":"string","description":"Data period end date. ABA week end date corresponding to the returned data (yyyy-MM-dd)","example":"2026-01-01"},"keywordDataUpdateTime":{"type":"string","description":"Keyword data update time","example":"phone case"}}}},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Latency (ms)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render columns","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Title","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"keyword":"phone case","keywordPopularityRank":1,"estimatedWeeklySearchVolume":1,"supplyDemandRatio":1,"totalSearchResultProductCount":1,"naturalSearchProductCount":1,"sponsoredProductsCount":1,"brandAdProductCount":1,"videoAdProductCount":1,"paidAdvertisingProductCount":1,"amazonChoiceProductCount":1,"topRatedProductCount":1,"searchRecommendationProductCount":1,"editorialRecommendationsProductCount":1,"recNonadProductCount":1,"recAdProductCount":1,"trackedAsinTotalCount":1,"totalMarketplaceKeywordCount":1,"dataPeriodStartDate":"2026-01-01","dataPeriodEndDate":"2026-01-01","keywordDataUpdateTime":"phone case"}],"costTime":1,"costToken":1,"columns":[]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-keyword-overview","x-nexscope-mcp-tool-name":"nexscope_amazon_keyword_overview","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-keyword-search-history/run":{"post":{"tags":["Keyword & Search Demand"],"summary":"Amazon Keyword Search History","description":"Nexscope keyword historical search volume query, returning Amazon keyword exact search volume trends in 7-day periods, covering 10 marketplaces including US, UK, DE, JP, etc. Trigger when the user mentions keyword search volume trends, historical search volume, search popularity changes, keyword seasonality, search volume fluctuations, Nexscope search volume, keyword search volume history, keyword trend, search volume over time, seasonal search volume, keyword popularity trend. Even if the user does not explicitly mention \"Nexscope\", if their need involves viewing the search volume trend of an Amazon keyword over time, this skill should also be triggered.","operationId":"runAmazonKeywordSearchHistory","externalDocs":{"description":"Amazon Keyword Search History documentation","url":"https://www.nexscope.ai/api-docs/amazon-keyword-search-history"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-keyword-search-history.","properties":{"marketplace":{"type":"string","description":"Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp","example":"us"},"keyword":{"type":"string","description":"Keyword to query","example":"phone case"},"startDate":{"type":"string","description":"Start date (format: YYYY-MM-DD)","example":"2026-01-01"},"endDate":{"type":"string","description":"End date (format: YYYY-MM-DD); max interval from startDate is 366 days","example":"2026-01-01"}},"required":["marketplace","keyword","startDate","endDate"],"example":{"marketplace":"us","endDate":"2025-03-31","keyword":"phone case","startDate":"2026-01-01"},"additionalProperties":true},"example":{"marketplace":"us","endDate":"2026-01-31","keyword":"phone case","startDate":"2026-01-01"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"historicalSearchVolumeList":{"anyOf":[{"type":"array","description":"Historical search volume period list","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Data period identifier (market/keyword/date range)","example":"example-id"},"estimateStartDate":{"type":"string","description":"Period start date (YYYY-MM-DD, 7-day statistical period start)","example":"2026-01-01"},"estimateEndDate":{"type":"string","description":"Period end date (YYYY-MM-DD, 7-day statistical period end)","example":"2026-01-01"},"estimatedExactSearchVolume":{"type":"integer","description":"Exact match search volume for this period (searches/week)","example":1},"type":{"type":"string","description":"Resource type, fixed value historical_keyword_search_volume","example":null}}}},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"costToken":1,"historicalSearchVolumeList":[{"id":"example-id","estimateStartDate":"2026-01-01","estimateEndDate":"2026-01-01","estimatedExactSearchVolume":1}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-keyword-search-history","x-nexscope-mcp-tool-name":"nexscope_amazon_keyword_search_history","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-keyword-share-of-voice/run":{"post":{"tags":["Keyword & Search Demand"],"summary":"Amazon Keyword Share Of Voice","description":"Nexscope keyword Share of Voice analysis, returning brand visibility share across the first 3 pages of Amazon search results (organic/ad/combined), 30-day exact search volume, median PPC bid, and TOP3 ASIN click and conversion data, covering 10 marketplaces. Trigger when the user mentions brand market share, brand voice share, search result brand distribution, Share of Voice, SOV analysis, brand competitive landscape, ad slot share, organic ranking brand share, PPC bid analysis, brand monopoly analysis, keyword share of voice, brand visibility, organic vs sponsored share, brand dominance, PPC bid analysis, search result brand distribution, competitive landscape, weighted SOV, top ASIN clicks conversions. Even if the user does not explicitly mention \"Share of Voice\" or \"SOV\", if their need involves analyzing brand market share or competitive landscape in Amazon keyword search results, this skill should also be triggered.","operationId":"runAmazonKeywordShareOfVoice","externalDocs":{"description":"Amazon Keyword Share Of Voice documentation","url":"https://www.nexscope.ai/api-docs/amazon-keyword-share-of-voice"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-keyword-share-of-voice.","properties":{"marketplace":{"type":"string","description":"Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp","example":"us"},"keyword":{"type":"string","description":"Keyword to query","example":"phone case"}},"required":["marketplace","keyword"],"example":{"marketplace":"us","keyword":"phone case"},"additionalProperties":true},"example":{"marketplace":"us","keyword":"phone case"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"shareOfVoice":{"anyOf":[{"type":"object","description":"Share of Voice data body","example":{},"properties":{"id":{"anyOf":[{"type":"string","description":"Resource identifier","example":"example-id"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Fixed value share_of_voice","example":null},{"type":"null"}]},"estimated30DaySearchVolume":{"anyOf":[{"type":"integer","description":"Exact match search volume over the past 30 days","example":1},{"type":"null"}]},"exactSuggestedBidMedian":{"anyOf":[{"type":"number","description":"PPC bid median (USD)","example":1},{"type":"null"}]},"productCount":{"anyOf":[{"type":"integer","description":"Total product count in the first 3 pages of search results","example":1},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string","description":"Data update time","example":"2026-01-01"},{"type":"null"}]},"topAsinsModelStartDate":{"anyOf":[{"type":"string","description":"TOP ASIN click/conversion data window start date","example":"B072MQ5BRX"},{"type":"null"}]},"topAsinsModelEndDate":{"anyOf":[{"type":"string","description":"TOP ASIN click/conversion data window end date","example":"B072MQ5BRX"},{"type":"null"}]},"brands":{"anyOf":[{"type":"array","description":"Brand SOV detail list","example":[],"items":{"type":"object","properties":{"brand":{"type":"string","description":"Brand name","example":null},"organicProducts":{"type":"integer","description":"Number of products in organic search results","example":1},"sponsoredProducts":{"type":"integer","description":"Number of products in ad placements","example":1},"combinedProducts":{"type":"integer","description":"Combined product count","example":1},"organicBasicSov":{"type":"number","description":"Organic basic SOV (0-1)","example":1},"organicWeightedSov":{"type":"number","description":"Organic weighted SOV (0-1)","example":1},"sponsoredBasicSov":{"type":"number","description":"Sponsored basic SOV (0-1)","example":1},"sponsoredWeightedSov":{"type":"number","description":"Sponsored weighted SOV (0-1)","example":1},"combinedBasicSov":{"type":"number","description":"Combined basic SOV (0-1)","example":1},"combinedWeightedSov":{"type":"number","description":"Combined weighted SOV (0-1)","example":1},"organicAveragePosition":{"type":"number","description":"Average organic search rank position","example":1},"sponsoredAveragePosition":{"type":"number","description":"Average sponsored search rank position","example":1},"combinedAveragePosition":{"type":"number","description":"Combined average rank position","example":1},"organicAveragePrice":{"type":"number","description":"Average organic search product price","example":1},"sponsoredAveragePrice":{"type":"number","description":"Average sponsored search product price","example":1},"combinedAveragePrice":{"type":"number","description":"Combined average product price","example":1}}}},{"type":"null"}]},"topAsins":{"anyOf":[{"type":"array","description":"TOP 3 ASIN click and conversion list","example":[],"items":{"type":"object","properties":{"asin":{"type":"string","description":"ASIN number","example":"B072MQ5BRX"},"name":{"type":"string","description":"Product name","example":null},"brand":{"type":"string","description":"Brand name","example":null},"clicks":{"type":"integer","description":"Click volume (30-day window)","example":1},"conversions":{"type":"integer","description":"Conversion volume (30-day window)","example":1},"conversionRate":{"type":"number","description":"Conversion rate (0-1)","example":1}}}},{"type":"null"}]}}},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"costToken":1,"shareOfVoice":{"id":"example-id","estimated30DaySearchVolume":1,"exactSuggestedBidMedian":1,"productCount":1,"updatedAt":"2026-01-01","topAsinsModelStartDate":"B072MQ5BRX","topAsinsModelEndDate":"B072MQ5BRX","brands":[{"organicProducts":1,"sponsoredProducts":1,"combinedProducts":1,"organicBasicSov":1,"organicWeightedSov":1,"sponsoredBasicSov":1,"sponsoredWeightedSov":1,"combinedBasicSov":1,"combinedWeightedSov":1,"organicAveragePosition":1,"sponsoredAveragePosition":1,"combinedAveragePosition":1,"organicAveragePrice":1,"sponsoredAveragePrice":1,"combinedAveragePrice":1}],"topAsins":[{"asin":"B072MQ5BRX","clicks":1,"conversions":1,"conversionRate":1}]}},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-keyword-share-of-voice","x-nexscope-mcp-tool-name":"nexscope_amazon_keyword_share_of_voice","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-keyword-summary/run":{"post":{"tags":["Keyword & Search Demand"],"summary":"Amazon Keyword Summary","description":"Break down all competitor ASIN traffic sources under a given keyword -- organic search, SP ads, SB brand ads, SBV video ads, SP recommendations, AC/ER/TR recommendation slots, with support for ASIN filtering, custom date ranges, and new traffic keyword filters. Trigger when the user mentions keyword traffic sources, which competitors are grabbing traffic under this keyword, organic traffic vs paid traffic share, SP ad exposure, brand ad share, SP recommendation slots, recommendation ad/non-ad split, search display analysis, Amazon's Choice or editorial recommendation exposure, keyword competitive landscape, ASIN traffic composition, keyword traffic, traffic structure analysis, search share, ad share, traffic source distribution, Nexscope, traffic analysis, SP recommendation, recommend position breakdown. Even if the user does not explicitly mention \"Nexscope\", if their need involves analyzing competitor ASIN traffic source distribution under a keyword, this skill should also be triggered.","operationId":"runAmazonKeywordSummary","externalDocs":{"description":"Amazon Keyword Summary documentation","url":"https://www.nexscope.ai/api-docs/amazon-keyword-summary"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-keyword-summary.","properties":{"searchKeyword":{"type":"string","description":"Search keyword, translate to the corresponding country's language whenever possible. Max length 1000 characters","example":"phone case"},"country":{"type":"string","description":"Country site, default US. Options (13 total): US, UK, DE, CA, JP, FR, ES, IT, MX, AU, AE, BR, SA"},"asins":{"type":"string","description":"ASIN filter list, comma-separated; if not provided, returns all ASINs for this keyword. Max length 1000 characters","example":"B072MQ5BRX"},"condition":{"type":"string","description":"Condition filter, only one at a time.<br>Flag type: nfPosition (natural traffic keyword), isSpAd (SP ad keyword), isVedioAd (video ad keyword), isBrandAd (brand ad keyword), isPPCAd (PPC ad keyword), isSearchRecommend (search recommendation keyword), acAd (SP recommendation)<br>Period count type: totalPeriod.in (new incoming traffic keywords), nfKeywordCnt.total / .in, adKeywordCnt.total / .in, allSpKeywordCnt.total / .in, spKeywordCnt.total / .in, recSpKeywordCnt.total / .in, allSbKeywordCnt.total / .in, sbKeywordCnt.total / .in, sbvKeywordCnt.total / .in"},"last7d":{"type":"boolean","description":"Whether to get last 7 days data, default true. When false, use startDate/endDate range","example":true},"startDate":{"type":"string","description":"Start date yyyy-MM-dd (effective when last7d=false; if omitted, the latest system full week is used)","example":"2026-01-01"},"endDate":{"type":"string","description":"End date yyyy-MM-dd (paired with startDate)","example":"2026-01-01"},"sortBy":{"type":"string","description":"Sort field. Options: totalKeywordNum (all traffic keywords), naturalKeywordNum (natural traffic keywords), brandKeywordNum (brand ad keywords), vedioKeywordNum (video ad keywords), acKeywordNum (AC recommended keywords), erKeywordNum (ER recommended keywords), trKeywordNum (TR recommended keywords), sumScore (total keyword exposure score), totalNfScore, totalSpSocre (note spelling), totalBrandScore, totalVedioScore, totalAcScore, totalTrScore, totalErScore"},"pageNum":{"type":"integer","description":"Page number, default 1","example":1},"pageSize":{"type":"integer","description":"Results per page, min 10, max 100, default 100","example":10},"desc":{"type":"boolean","description":"Whether to sort descending, default true","example":true}},"required":["searchKeyword"],"example":{"searchKeyword":"phone case","pageSize":10,"last7d":true,"pageNum":1,"country":"US"},"additionalProperties":true},"example":{"searchKeyword":"phone case","pageSize":10,"last7d":true,"pageNum":1,"country":"US"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of data records actually returned","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Return data, array of product keyword traffic data objects","example":[],"items":{"type":"object","properties":{"asin":{"type":"string","description":"ASIN code","example":"B072MQ5BRX"},"productTitle":{"type":"string","description":"Product title","example":null},"productImageUrl":{"type":"string","description":"Product main image URL","example":"https://example.com/image.jpg"},"productPrice":{"type":"number","description":"Product price","example":1},"customerRatingCount":{"type":"integer","description":"Total customer rating count","example":1},"productStarRating":{"type":"number","description":"Product star rating (0-5 stars)","example":1},"productRatingScore":{"type":"number","description":"Product rating score value","example":1},"productUpdateTime":{"type":"string","description":"Product update time (yyyy-MM-dd HH:mm:ss)","example":"2026-01-01"},"dataPeriodStartDate":{"type":"string","description":"Data period start date (yyyy-MM-dd)","example":"2026-01-01"},"totalExposureScore":{"type":"number","description":"Total exposure score","example":1},"totalExposureRatio":{"type":"number","description":"Total traffic share","example":1},"naturalSearchExposureScore":{"type":"number","description":"Natural search exposure total score","example":1},"naturalSearchExposureRatio":{"type":"number","description":"Natural search exposure ratio","example":1},"sponsoredProductsExposureScore":{"type":"number","description":"SP ad exposure total score","example":1},"sponsoredProductsExposureRatio":{"type":"number","description":"SP ad exposure ratio","example":1},"brandAdExposureScore":{"type":"number","description":"Brand ad exposure total score","example":1},"brandAdExposureRatio":{"type":"number","description":"Brand ad exposure ratio","example":1},"videoAdExposureScore":{"type":"number","description":"Video ad exposure total score","example":1},"videoAdExposureRatio":{"type":"number","description":"Video ad exposure ratio","example":1},"amazonsChoiceExposureScore":{"type":"number","description":"AC exposure total score","example":1},"amazonsChoiceExposureRatio":{"type":"number","description":"AC exposure ratio","example":1},"editorialRecommendationsExposureScore":{"type":"number","description":"ER exposure total score","example":1},"editorialRecommendationsExposureRatio":{"type":"number","description":"ER exposure ratio","example":1},"topRatedExposureScore":{"type":"number","description":"TR exposure total score","example":1},"topRatedExposureRatio":{"type":"number","description":"TR exposure ratio","example":1},"recommendPositionExposureScore":{"type":"number","description":"Recommendation position exposure total score","example":1},"recommendAdExposureScore":{"type":"number","description":"Recommendation position ad exposure score","example":1},"recommendAdExposureRatio":{"type":"number","description":"Recommendation position ad traffic share","example":1},"recommendNonadExposureScore":{"type":"number","description":"Recommendation position non-ad exposure score","example":1},"recommendNonadExposureRatio":{"type":"number","description":"Recommendation position non-ad traffic share","example":1},"comprehensiveNaturalExposureScore":{"type":"number","description":"Comprehensive natural traffic score (natural search + recommendation non-ad)","example":1},"comprehensiveNaturalExposureRatio":{"type":"number","description":"Comprehensive natural traffic share","example":1},"keywordTotalExposureScore":{"type":"number","description":"Keyword total score","example":1},"keywordNaturalExposureScore":{"type":"number","description":"Keyword natural score","example":1},"keywordSponsoredProductsExposureScore":{"type":"number","description":"Keyword SP ad score","example":1},"keywordBrandAdExposureScore":{"type":"number","description":"Keyword brand ad score","example":1},"keywordVideoAdExposureScore":{"type":"number","description":"Keyword video ad score","example":1},"keywordAmazonsChoiceExposureScore":{"type":"number","description":"Keyword AC score","example":1},"keywordRecommendExposureScore":{"type":"number","description":"Keyword recommendation position score","example":1},"keywordRecommendAdExposureScore":{"type":"number","description":"Keyword recommendation position ad score","example":1},"keywordRecommendNonadExposureScore":{"type":"number","description":"Keyword recommendation position non-ad score","example":1},"keywordComprehensiveNaturalExposureScore":{"type":"number","description":"Keyword comprehensive natural score (natural + recommendation non-ad)","example":1},"ppcTrafficSources":{"type":"array","description":"PPC paid ad traffic source markers. Contains: SP ads, top brand ads, bottom brand ads, video ads","example":[]},"naturalSearchTrafficSources":{"type":"array","description":"Natural search traffic source markers","example":[]},"amazonRecommendationSources":{"type":"array","description":"Amazon recommendation traffic source markers. Contains: Best Seller, AC, ER, TR, TRFOB, etc.","example":[]},"promotionalDealSources":{"type":"array","description":"Promotional deal traffic source markers. Contains: Coupon, Limited Time Deal, Lowest Price in 30 Days, etc.","example":[]}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render columns","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Title","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Latency (ms)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"asin":"B072MQ5BRX","productImageUrl":"https://example.com/image.jpg","productPrice":1,"customerRatingCount":1,"productStarRating":1,"productRatingScore":1,"productUpdateTime":"2026-01-01","dataPeriodStartDate":"2026-01-01","totalExposureScore":1,"totalExposureRatio":1,"naturalSearchExposureScore":1,"naturalSearchExposureRatio":1,"sponsoredProductsExposureScore":1,"sponsoredProductsExposureRatio":1,"brandAdExposureScore":1,"brandAdExposureRatio":1,"videoAdExposureScore":1,"videoAdExposureRatio":1,"amazonsChoiceExposureScore":1,"amazonsChoiceExposureRatio":1,"editorialRecommendationsExposureScore":1,"editorialRecommendationsExposureRatio":1,"topRatedExposureScore":1,"topRatedExposureRatio":1,"recommendPositionExposureScore":1,"recommendAdExposureScore":1,"recommendAdExposureRatio":1,"recommendNonadExposureScore":1,"recommendNonadExposureRatio":1,"comprehensiveNaturalExposureScore":1,"comprehensiveNaturalExposureRatio":1,"keywordTotalExposureScore":1,"keywordNaturalExposureScore":1,"keywordSponsoredProductsExposureScore":1,"keywordBrandAdExposureScore":1,"keywordVideoAdExposureScore":1,"keywordAmazonsChoiceExposureScore":1,"keywordRecommendExposureScore":1,"keywordRecommendAdExposureScore":1,"keywordRecommendNonadExposureScore":1,"keywordComprehensiveNaturalExposureScore":1,"ppcTrafficSources":[],"naturalSearchTrafficSources":[],"amazonRecommendationSources":[],"promotionalDealSources":[]}],"columns":[],"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-keyword-summary","x-nexscope-mcp-tool-name":"nexscope_amazon_keyword_summary","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-market-product-detail/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Market Product Detail","description":"Query Amazon product detail and historical trends by ASIN using Nexscope data, covering 14 marketplaces. Trigger when the user mentions Nexscope product detail, ASIN detail query, sales trends, price curves, price history, BSR ranking history, BSR trends, profit analysis, FBA fee analysis, gross margin, product trend analysis, daily/monthly sales, revenue trends, Deal promotion history, product detail, sales trend, price history, BSR ranking, profit analysis, FBA fees. Even if the user does not explicitly mention \"Nexscope\", if their need involves querying Amazon product detail or historical trend data by ASIN, this skill should also be triggered.","operationId":"runAmazonMarketProductDetail","externalDocs":{"description":"Amazon Market Product Detail documentation","url":"https://www.nexscope.ai/api-docs/amazon-market-product-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-market-product-detail.","properties":{"asin":{"type":"string","description":"Amazon Standard Identification Number (ASIN), supports multiple (max 10), comma-separated. Example: B0088PUEPK or B0088PUEPK,B00U26V4VQ","example":"B072MQ5BRX"},"marketplace":{"type":"string","description":"Amazon site code: us, gb, de, fr, in, ca, jp, es, it, mx, ae, au, br, sa","example":"us"},"includeTrend":{"type":"integer","description":"Whether to include trend data. 1: include (default); 2: exclude","example":1},"queryTrendStartDate":{"type":"string","description":"Trend start date, format yyyy-MM-dd. Default returns only the last 15 days; querying more than 15 days doubles the cost","example":"2026-01-01"},"queryTrendEndDate":{"type":"string","description":"Trend end date, format yyyy-MM-dd","example":"2026-01-15"}},"required":["asin","marketplace"],"example":{"queryTrendEndDate":"2026-01-15","marketplace":"us","asin":"B072MQ5BRX","includeTrend":1,"queryTrendStartDate":"2026-01-01"},"additionalProperties":true},"example":{"queryTrendEndDate":"2026-01-15","marketplace":"us","asin":"B072MQ5BRX","includeTrend":1,"queryTrendStartDate":"2026-01-01"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total result count","example":1},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Latency (ms)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"requestConsumed":{"anyOf":[{"type":"integer","description":"Requests consumed","example":1},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type: Nexscope","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render columns","example":[]},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product detail list (see below)","example":[],"items":{"type":"object","properties":{"asin":{"type":"string","description":"ASIN","example":"B072MQ5BRX"},"title":{"type":"string","description":"Product title","example":null},"brand":{"type":"string","description":"Brand","example":null},"asinUrl":{"type":"string","description":"Product link, Amazon Listing detail page URL","example":"B072MQ5BRX"},"imageUrl":{"type":"string","description":"Main image URL","example":"https://example.com/image.jpg"},"productImageUrls":{"type":"array","description":"Main image list (all product image URLs)","example":[]},"ebcPhoto":{"type":"array","description":"A+ image list","example":[]},"storeName":{"type":"string","description":"Store name","example":null},"description":{"type":"string","description":"Five bullet points","example":null},"productBadge":{"type":"array","description":"Product badges, e.g. Amazon Choice, Best Seller, New Release, etc.","example":[]},"lastUpdate":{"type":"string","description":"Update time, most recent ASIN data collection time (format yyyy-MM-dd)","example":"2026-01-01"},"offSale":{"type":"boolean","description":"Whether delisted. true = unavailable, false = available","example":false},"productType":{"type":"string","description":"Category, Amazon product category node name","example":null},"weight":{"type":"string","description":"Weight, unit g","example":null},"size":{"type":"array","description":"Dimensions, outer packaging [longest side, second longest side, shortest side], unit cm","example":[]},"parentAsin":{"type":"string","description":"Parent ASIN, the parent ASIN if variants exist, null if no variants","example":"B072MQ5BRX"},"variationNum":{"type":"integer","description":"Number of variations","example":1},"variationASIN":{"type":"array","description":"Child ASIN list, empty if no variants","example":[]},"attribute":{"type":"array","description":"Product attributes, variant attributes if variants exist. Each entry contains asin (child ASIN), name (attribute name), value (attribute value)","example":[]},"price":{"type":"number","description":"Selling price, actual price after coupon deduction, in local currency (e.g. USD)","example":1},"coupon":{"type":"integer","description":"Coupon policy. Value >= 0 = deduction amount (e.g. 500 = $5), value < 0 = discount percentage (e.g. -10 = 10% discount)","example":1},"platformFee":{"type":"number","description":"Platform commission, in local currency (e.g. USD)","example":1},"fbaFees":{"type":"number","description":"FBA fees, in local currency (e.g. USD)","example":1},"fbaDetail":{"type":"array","description":"FBA detail. First item is delivery fee, subsequent items are month:storage fee, e.g. [475,\"1-9:5\",\"10-12:15\"]","example":[]},"shipCost":{"type":"number","description":"FBM shipping cost, in local currency (e.g. USD)","example":1},"shipsFrom":{"type":"string","description":"Ship-from location","example":null},"profitAmount":{"type":"number","description":"Profit, final price - FBA fee - commission, in local currency (e.g. USD)","example":1},"profitRate":{"type":"number","description":"Profit margin, e.g. 25.83 means 25.83%","example":1},"monthlySalesUnits":{"type":"integer","description":"Official monthly sales volume, Amazon published ASIN monthly sales, latest value from the last 7 calendar days, 0 if unavailable","example":1},"salesRank":{"type":"integer","description":"BSR rank, main category rank","example":1},"category":{"type":"array","description":"Main category, [category name, NodeId]","example":[]},"bsrCategory":{"type":"array","description":"Subcategory rank list, each entry containing nodeId (node ID), name (category name), rank (rank), date (date, format yyyyMMdd)","example":[]},"availableDate":{"type":"string","description":"Listing time, format yyyy-MM-dd","example":"2026-01-01"},"onlineDays":{"type":"integer","description":"Days since listing","example":1},"rating":{"type":"number","description":"Current rating (0.0-5.0, e.g. 4.70)","example":1},"ratings":{"type":"integer","description":"Number of ratings","example":1},"fiveStarRatings":{"type":"number","description":"5-star percentage, e.g. 57.7 means 57.7%","example":1},"fourStarRatings":{"type":"number","description":"4-star percentage","example":1},"threeStarRatings":{"type":"number","description":"3-star percentage","example":1},"twoStarRatings":{"type":"number","description":"2-star percentage","example":1},"oneStarRatings":{"type":"number","description":"1-star percentage","example":1},"buyboxSeller":{"type":"string","description":"Buybox seller name","example":null},"buyBoxSellerId":{"type":"string","description":"Buybox seller ID","example":"example-id"},"buyboxSellerAddress":{"type":"string","description":"Seller location, Buybox seller nationality (two-letter code e.g. CN, US), null if Amazon's own","example":null},"isFBA":{"type":"boolean","description":"Whether FBA, whether Buybox seller uses FBA logistics","example":false},"sellerNum":{"type":"integer","description":"Number of sellers","example":1},"aPlus":{"type":"boolean","description":"Has A+","example":false},"hasVideo":{"type":"boolean","description":"Has video","example":false},"hasBrandStore":{"type":"boolean","description":"Has brand store","example":false},"feature":{"type":"object","description":"Product feature ratings, features and star ratings collected by Amazon for this product, e.g. {\"Battery life\":4.0}","example":{}},"productInfo":{"type":"object","description":"Product information, structured data from the Product Information section in the Listing","example":{}},"property":{"type":"object","description":"Attribute list, including variant attributes and Bullet Points header descriptions","example":{}},"brandPromotion":{"type":"string","description":"Brand promotion","example":null},"dealType":{"type":"string","description":"Deal label","example":null},"extraSavings":{"type":"array","description":"Associated promotions, e.g. [{Asin:xxx, Text:\"Save 5%...\"}]","example":[]},"rankTrend":{"type":"array","description":"BSR trend, main category rank change history, interleaved format [date, rank, ...]","example":[]},"bsrRankTrend":{"type":"array","description":"Subcategory rank trend, JSON format [{NodeId:xxx, Rank:[date, rank, ...]}]","example":[]},"listingSalesVolumeOfDailyTrend":{"type":"array","description":"Daily sales volume trend, value -1 means unable to estimate","example":[]},"listingSalesOfDailyTrend":{"type":"array","description":"Daily sales revenue trend, in local currency smallest unit (e.g. cents), value -1 means unable to estimate","example":[]},"listingSalesVolumeOfMonthTrend":{"type":"array","description":"Monthly sales volume trend (last 30 days), value -1 means unable to estimate","example":[]},"listingSalesOfMonthTrend":{"type":"array","description":"Monthly sales revenue trend, in local currency smallest unit (e.g. cents)","example":[]},"priceTrend":{"type":"array","description":"Selling price trend, before coupon, in local currency smallest unit, -1 means no price available for that day","example":[]},"listPriceTrend":{"type":"array","description":"Original price trend (strikethrough price history), in local currency smallest unit, -1 means no price available for that day","example":[]},"dealTrend":{"type":"array","description":"Deal trend, value 1 = has deal, 0 = no deal","example":[]}}}},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"costTime":1,"costToken":1,"requestConsumed":1,"columns":[],"products":[{"asin":"B072MQ5BRX","asinUrl":"B072MQ5BRX","imageUrl":"https://example.com/image.jpg","productImageUrls":[],"ebcPhoto":[],"productBadge":[],"lastUpdate":"2026-01-01","offSale":false,"size":[],"parentAsin":"B072MQ5BRX","variationNum":1,"variationASIN":[],"attribute":[],"price":1,"coupon":1,"platformFee":1,"fbaFees":1,"fbaDetail":[],"shipCost":1,"profitAmount":1,"profitRate":1,"monthlySalesUnits":1,"salesRank":1,"category":[],"bsrCategory":[],"availableDate":"2026-01-01","onlineDays":1,"rating":1,"ratings":1,"fiveStarRatings":1,"fourStarRatings":1,"threeStarRatings":1,"twoStarRatings":1,"oneStarRatings":1,"buyBoxSellerId":"example-id","isFBA":false,"sellerNum":1,"aPlus":false,"hasVideo":false,"hasBrandStore":false,"feature":{},"productInfo":{},"property":{},"extraSavings":[],"rankTrend":[],"bsrRankTrend":[],"listingSalesVolumeOfDailyTrend":[],"listingSalesOfDailyTrend":[],"listingSalesVolumeOfMonthTrend":[],"listingSalesOfMonthTrend":[],"priceTrend":[],"listPriceTrend":[],"dealTrend":[]}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-market-product-detail","x-nexscope-mcp-tool-name":"nexscope_amazon_market_product_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-market-product-search/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Market Product Search","description":"Multi-dimensional Amazon product search and filtering based on Nexscope data, covering 14 marketplaces, with support for historical monthly snapshot lookback. Trigger when the user mentions Nexscope product search, Amazon product filtering, competitor research, category analysis, brand bestsellers, seller analysis, seasonal products, historical snapshot review, product search, monthly sales/revenue, ABA keyword product discovery, price range filtering, new product discovery, multi-condition combined filtering, product search, competitor research, category analysis, brand bestsellers, seller analysis, seasonal products, historical snapshot. Even if the user does not explicitly mention \"Nexscope\", if their need involves Amazon product search, filtering, comparison, or product exploration by category/brand/seller dimensions, this skill should also be triggered.","operationId":"runAmazonMarketProductSearch","externalDocs":{"description":"Amazon Market Product Search documentation","url":"https://www.nexscope.ai/api-docs/amazon-market-product-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-market-product-search.","properties":{"marketplace":{"type":"string","description":"Amazon site code: us, gb, de, fr, in, ca, jp, es, it, mx, ae, au, br, sa","example":"us"},"queryMode":{"type":"integer","description":"Query mode. 1: single condition query (default); 2: multi-condition combined query (AND relationship)","example":1},"queryType":{"type":"integer","description":"Query type (1-16), only effective when queryMode=1. See the complete Query Types description in SKILL.md","example":1},"queryValue":{"type":"string","description":"Query condition value, format varies by queryMode and queryType. See the format description for each queryType in SKILL.md","example":"phone case"},"page":{"type":"integer","description":"Page number, default 1. Max 100 products per page","example":1},"queryMonth":{"type":"string","description":"Historical month lookback, format yyyy-MM. When not specified, queries real-time data","example":"2026-01"}},"required":["marketplace"],"example":{"queryMode":1,"marketplace":"us","queryType":1,"queryValue":"B072MQ5BRX","page":1},"additionalProperties":true},"example":{"queryMode":1,"marketplace":"us","queryType":1,"queryValue":"B072MQ5BRX","page":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total result count","example":1},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page number","example":1},{"type":"null"}]},"pageCount":{"anyOf":[{"type":"integer","description":"Total page count (max 200 pages)","example":1},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Latency (ms)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"requestConsumed":{"anyOf":[{"type":"integer","description":"Requests consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render columns","example":[]},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list (see below)","example":[],"items":{"type":"object","properties":{"asin":{"type":"string","description":"ASIN","example":"B072MQ5BRX"},"title":{"type":"string","description":"Product title","example":null},"brand":{"type":"string","description":"Brand","example":null},"asinUrl":{"type":"string","description":"Product link, Amazon Listing detail page URL","example":"B072MQ5BRX"},"imageUrl":{"type":"string","description":"Main image URL","example":"https://example.com/image.jpg"},"productImageUrls":{"type":"array","description":"Main image list (all product image URLs)","example":[]},"parentAsin":{"type":"string","description":"Parent ASIN, the parent ASIN if variants exist, null if no variants","example":"B072MQ5BRX"},"variationNum":{"type":"integer","description":"Number of variations","example":1},"weight":{"type":"string","description":"Weight, unit g","example":null},"size":{"type":"array","description":"Dimensions, outer packaging [longest side, second longest side, shortest side], unit cm","example":[]},"price":{"type":"number","description":"Current price, before coupon, in local currency (e.g. USD)","example":1},"oldPrice":{"type":"number","description":"Strikethrough price, in local currency (e.g. USD)","example":1},"salesPrice":{"type":"number","description":"Final price, actual price after coupon deduction, in local currency (e.g. USD)","example":1},"coupon":{"type":"integer","description":"Coupon policy. Value >= 0 = deduction amount (e.g. 500 = $5), value < 0 = discount percentage (e.g. -10 = 10% discount)","example":1},"fbaFees":{"type":"number","description":"FBA fees, in local currency (e.g. USD)","example":1},"fbaDetail":{"type":"array","description":"FBA detail. First item is delivery fee, subsequent items are month:storage fee, e.g. [475,\"1-9:5\",\"10-12:15\"]","example":[]},"platformFee":{"type":"number","description":"Platform commission, in local currency (e.g. USD)","example":1},"profitAmount":{"type":"number","description":"Profit, final price - FBA fee - commission, in local currency (e.g. USD)","example":1},"profitRate":{"type":"number","description":"Profit margin, e.g. 25.83 means 25.83%","example":1},"monthlySalesUnits":{"type":"integer","description":"Monthly sales volume, last 30 days Listing-level (does not split by variant), recommended for evaluating sales, value -1 means unable to estimate","example":1},"monthlySalesRevenue":{"type":"number","description":"Monthly sales revenue, estimated value, in local currency (e.g. USD), value -1 means unable to estimate","example":1},"listingSalesVolumeOfDaily":{"type":"integer","description":"Daily sales volume, Listing-level (does not split by variant), value -1 means unable to estimate","example":1},"listingSalesOfDaily":{"type":"number","description":"Daily sales revenue, in local currency (e.g. USD), value -1 means unable to estimate","example":1},"salesRank":{"type":"integer","description":"BSR rank, main category rank","example":1},"category":{"type":"array","description":"Main category, [category name, NodeId]","example":[]},"bsrCategory":{"type":"array","description":"Subcategory rank list, each entry containing nodeId (node ID), name (category name), rank (rank), date (date, format yyyyMMdd)","example":[]},"rating":{"type":"number","description":"Current rating (0.0-5.0, e.g. 4.8)","example":1},"ratings":{"type":"integer","description":"Number of ratings","example":1},"availableDate":{"type":"string","description":"Listing time, format yyyy-MM-dd","example":"2026-01-01"},"onlineDays":{"type":"integer","description":"Days since listing","example":1},"buyboxSeller":{"type":"string","description":"Buybox seller name","example":null},"buyBoxSellerId":{"type":"string","description":"Buybox seller ID","example":"example-id"},"buyboxSellerAddress":{"type":"string","description":"Seller location, Buybox seller nationality (two-letter code e.g. CN, US), null if Amazon's own","example":null},"isFBA":{"type":"boolean","description":"Whether FBA, whether Buybox seller uses FBA logistics","example":false},"sellerNum":{"type":"integer","description":"Number of sellers","example":1},"aPlus":{"type":"boolean","description":"Has A+","example":false},"hasVideo":{"type":"boolean","description":"Has video","example":false},"hasBrandStore":{"type":"boolean","description":"Has brand store","example":false}}}},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"page":1,"pageCount":1,"costTime":1,"costToken":1,"requestConsumed":1,"columns":[],"products":[{"asin":"B072MQ5BRX","asinUrl":"B072MQ5BRX","imageUrl":"https://example.com/image.jpg","productImageUrls":[],"parentAsin":"B072MQ5BRX","variationNum":1,"size":[],"price":1,"oldPrice":1,"salesPrice":1,"coupon":1,"fbaFees":1,"fbaDetail":[],"platformFee":1,"profitAmount":1,"profitRate":1,"monthlySalesUnits":1,"monthlySalesRevenue":1,"listingSalesVolumeOfDaily":1,"listingSalesOfDaily":1,"salesRank":1,"category":[],"bsrCategory":[],"rating":1,"ratings":1,"availableDate":"2026-01-01","onlineDays":1,"buyBoxSellerId":"example-id","isFBA":false,"sellerNum":1,"aPlus":false,"hasVideo":false,"hasBrandStore":false}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-market-product-search","x-nexscope-mcp-tool-name":"nexscope_amazon_market_product_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-market-research/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Market Research","description":"Use Nexscope market list capability to filter Amazon niche markets by category dimensions, supporting market size, competition, top concentration, seller structure, new product share, price/rating/margin ranges, and many other criteria for discovering viable markets and evaluating product selection directions. Trigger when the user mentions Amazon market research, niche category research, market opportunity screening, market concentration analysis, new product opportunities, market selection, Nexscope market research, category market research. Even if the user does not explicitly mention \"Nexscope\", if the need is to screen and evaluate Amazon markets by category dimensions, this skill should also be triggered.","operationId":"runAmazonMarketResearch","externalDocs":{"description":"Amazon Market Research documentation","url":"https://www.nexscope.ai/api-docs/amazon-market-research"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-market-research.","properties":{"marketplace":{"type":"string","description":"Site code, see [marketplace](#marketplace-options)","example":"US"},"nodeIdPath":{"type":"string","description":"Category node ID path, e.g. 172282:281407"},"departmentKeyword":{"type":"string","description":"Category keyword path, e.g. Electronics:Accessories & Supplies","example":"phone case"},"sellerLocation":{"type":"string","description":"Seller location, multiple values comma-separated; see Nexscope table 1.3 for values"},"newProduct":{"type":"integer","description":"New product definition (months)","example":1},"topNum":{"type":"integer","description":"Top Listing count","example":1},"month":{"type":"string","description":"Filter date: nearly or yyyyMM"},"page":{"type":"integer","description":"Page number, starting from 1","example":1},"size":{"type":"integer","description":"Results per page","example":1},"orderField":{"type":"string","description":"Sort field, see [orderField](#orderfield-options)"},"orderDesc":{"type":"boolean","description":"true descending, false ascending","example":false},"minAvgRevenue/maxAvgRevenue":{"type":"number","description":"Minimum / maximum average monthly sales revenue","example":1},"minAvgUnits/maxAvgUnits":{"type":"integer","description":"Minimum / maximum average monthly sales volume","example":1},"minGoodsCount/maxGoodsCount":{"type":"integer","description":"Minimum / maximum product count","example":1},"minSellers/maxSellers":{"type":"integer","description":"Minimum / maximum seller count","example":1},"minBrands/maxBrands":{"type":"integer","description":"Minimum / maximum brand count","example":1},"minAvgSellers/maxAvgSellers":{"type":"number","description":"Minimum / maximum average seller count","example":1},"minGoodsCrn/maxGoodsCrn":{"type":"number","description":"Minimum / maximum product concentration (decimal 0-1)","example":1},"minSellerCrn/maxSellerCrn":{"type":"number","description":"Minimum / maximum seller concentration (decimal 0-1)","example":1},"minBrandCrn/maxBrandCrn":{"type":"number","description":"Minimum / maximum brand concentration (decimal 0-1)","example":1},"minAmazonSelfProportion/maxAmazonSelfProportion":{"type":"number","description":"Minimum / maximum Amazon self-operated share (decimal 0-1)","example":1},"minFbaProportion/maxFbaProportion":{"type":"number","description":"Minimum / maximum FBA share (decimal 0-1)","example":1},"minFbmProportion/maxFbmProportion":{"type":"number","description":"Minimum / maximum FBM share (decimal 0-1)","example":1},"minEbcProportion/maxEbcProportion":{"type":"number","description":"Minimum / maximum A+ share (decimal 0-1)","example":1},"minNewProportion/maxNewProportion":{"type":"number","description":"Minimum / maximum new product share (scale may differ from other ratio fields; refer to tool schema / actual network behavior)","example":1},"minAvgPrice/maxAvgPrice":{"type":"number","description":"Minimum / maximum average price","example":1},"minAvgRating/maxAvgRating":{"type":"number","description":"Minimum / maximum average rating value","example":1},"minAvgRatings/maxAvgRatings":{"type":"integer","description":"Minimum / maximum average review count","example":1},"minAvgProfit/maxAvgProfit":{"type":"number","description":"Minimum / maximum average gross margin (input N means N%, 0-100)","example":1},"minAvgBsr/maxAvgBsr":{"type":"integer","description":"Minimum / maximum average BSR rank","example":1},"minNewCount/maxNewCount":{"type":"integer","description":"Minimum / maximum new product count","example":1},"minNewAvgPrice/maxNewAvgPrice":{"type":"number","description":"Minimum / maximum new product average price","example":1},"minNewAvgRating/maxNewAvgRating":{"type":"number","description":"Minimum / maximum new product average star rating","example":1},"minNewAvgRatings/maxNewAvgRatings":{"type":"integer","description":"Minimum / maximum new product average review count","example":1},"minNewAvgUnits/maxNewAvgUnits":{"type":"number","description":"Minimum / maximum new product average monthly sales","example":1},"minNewAvgRevenue/maxNewAvgRevenue":{"type":"number","description":"Minimum / maximum new product average monthly revenue","example":1},"minTopAvgUnits/maxTopAvgUnits":{"type":"integer","description":"Minimum / maximum top listing average monthly sales","example":1},"minTopAvgRevenue/maxTopAvgRevenue":{"type":"number","description":"Minimum / maximum top listing average monthly revenue","example":1},"minTopAvgBsr/maxTopAvgBsr":{"type":"integer","description":"Minimum / maximum top listing average BSR","example":1},"minWeight/maxWeight":{"type":"number","description":"Minimum / maximum weight","example":1},"minVolume/maxVolume":{"type":"number","description":"Minimum / maximum volume","example":1}},"required":["marketplace"],"example":{"page":1,"topNum":1,"marketplace":"US","size":1,"newProduct":1,"departmentKeyword":"phone case"},"additionalProperties":true},"example":{"page":1,"topNum":1,"marketplace":"US","size":1,"newProduct":1,"departmentKeyword":"phone case"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total record count","example":1},{"type":"null"}]},"marketplace":{"anyOf":[{"type":"string","description":"Site code","example":"US"},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Category market list (corresponds to third-party data.items)","example":[],"items":{"type":"object","properties":{"nodeId":{"type":"string","description":"Node ID","example":"example-id"},"nodeIdPath":{"type":"string","description":"Node ID path","example":null},"nodeLabelName":{"type":"string","description":"Node name","example":null},"nodeLabelPath":{"type":"string","description":"Node name path","example":null},"nodeLabelLocale":{"type":"string","description":"Node name translation","example":null},"nodeLabelPathLocale":{"type":"string","description":"Node name path translation","example":null},"marketplace":{"type":"string","description":"Market identifier","example":"US"},"currency":{"type":"string","description":"Currency type for this market","example":null},"ranking":{"type":"integer","description":"Rank","example":1},"totalProducts":{"type":"integer","description":"Total product count","example":1},"topProducts":{"type":"integer","description":"Sample count","example":1},"sellers":{"type":"integer","description":"Seller count","example":1},"brands":{"type":"integer","description":"Brand count","example":1},"avgSellers":{"type":"number","description":"Average seller count","example":1},"avgUnits":{"type":"integer","description":"Average monthly sales volume","example":1},"totalUnits":{"type":"integer","description":"Total monthly sales volume","example":1},"avgRevenue":{"type":"number","description":"Average monthly sales revenue","example":1},"totalRevenue":{"type":"number","description":"Total monthly sales revenue","example":1},"avgPrice":{"type":"number","description":"Average price","example":1},"avgRating":{"type":"number","description":"Average rating value","example":1},"avgRatings":{"type":"integer","description":"Average review count","example":1},"avgBsr":{"type":"integer","description":"Average BSR","example":1},"avgProfit":{"type":"number","description":"Average profit margin (%)","example":1},"fbaProportion":{"type":"number","description":"FBA share (%)","example":1},"fbmProportion":{"type":"number","description":"FBM share (%)","example":1},"amazonSelfProportion":{"type":"number","description":"Amazon self-operated share (%)","example":1},"ebcProportion":{"type":"number","description":"A+ product share (%)","example":1},"returnRatio":{"type":"number","description":"Return rate (%)","example":1},"avgReturnRatio":{"type":"number","description":"Category average return rate (%)","example":1},"searchToPurchaseRatio":{"type":"number","description":"Search-to-purchase ratio (per mille)","example":1},"sellerNation":{"type":"string","description":"Most common seller location code","example":null},"sellerNationLabel":{"type":"string","description":"Most common seller location label","example":null},"sellerProportion":{"type":"number","description":"Most common seller location share (%)","example":1},"avgWeight":{"type":"number","description":"Average weight (pound)","example":1},"baseAvgWeight":{"type":"number","description":"Average weight (g)","example":1},"avgVolume":{"type":"number","description":"Average volume (in³)","example":1},"baseAvgVolume":{"type":"number","description":"Average volume (cm³)","example":1},"top10Images":{"type":"array","description":"Top 10 product images, elements see table below","example":[],"items":{"type":"object","properties":{"image":{"type":"string","description":"Image link","example":"https://example.com/image.jpg"},"asin":{"type":"string","description":"ASIN","example":"B072MQ5BRX"}}}}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render columns","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"marketplace":"US","data":[{"nodeId":"example-id","marketplace":"US","ranking":1,"totalProducts":1,"topProducts":1,"sellers":1,"brands":1,"avgSellers":1,"avgUnits":1,"totalUnits":1,"avgRevenue":1,"totalRevenue":1,"avgPrice":1,"avgRating":1,"avgRatings":1,"avgBsr":1,"avgProfit":1,"fbaProportion":1,"fbmProportion":1,"amazonSelfProportion":1,"ebcProportion":1,"returnRatio":1,"avgReturnRatio":1,"searchToPurchaseRatio":1,"sellerProportion":1,"avgWeight":1,"baseAvgWeight":1,"avgVolume":1,"baseAvgVolume":1,"top10Images":[{"image":"https://example.com/image.jpg","asin":"B072MQ5BRX"}]}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-market-research","x-nexscope-mcp-tool-name":"nexscope_amazon_market_research","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-market-statistics/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Market Statistics","description":"Use Nexscope market statistics capability to output a market statistics dashboard by category node, including top listing average rating, average price, BSR, sales, seller count, and new product related metrics, suitable for quickly assessing the market quality and competitive landscape of a category. Trigger when the user mentions category market statistics, market selection dashboard, market fundamentals assessment, node market quality, top product statistics, Nexscope market statistics, category statistics. Even if the user does not explicitly mention \"Nexscope\", if the need is to view aggregated statistical results by category node, this skill should also be triggered.","operationId":"runAmazonMarketStatistics","externalDocs":{"description":"Amazon Market Statistics documentation","url":"https://www.nexscope.ai/api-docs/amazon-market-statistics"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-market-statistics.","properties":{"marketplace":{"type":"string","description":"Site code, see [marketplace](#marketplace-options)","example":"US"},"nodeIdPath":{"type":"string","description":"Node ID path string, e.g. 1064954:1069242:1069784:1069820:1069838:1069828","example":"1064954:1069242"},"month":{"type":"string","description":"Filter date: nearly or yyyyMM"},"topN":{"type":"integer","description":"Top Listing count (used for top-related metric definitions)","example":1},"newProduct":{"type":"integer","description":"New product definition (months)","example":1}},"required":["marketplace","nodeIdPath"],"example":{"newProduct":1,"marketplace":"US","nodeIdPath":"1064954:1069242","topN":1},"additionalProperties":true},"example":{"newProduct":1,"marketplace":"US","nodeIdPath":"1064954:1069242","topN":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total record count","example":1},{"type":"null"}]},"marketplace":{"anyOf":[{"type":"string","description":"Site code","example":"US"},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Statistics result list (corresponds to third-party data)","example":[],"items":{"type":"object","properties":{"marketplace":{"type":"string","description":"Site code for this statistics row","example":"US"},"nodeIdPath":{"type":"string","description":"Node ID path","example":null},"nodeLabelPath":{"type":"string","description":"Node name path","example":null},"nodeLabelLocale":{"type":"string","description":"Node name translation","example":null},"nodeLabelPathLocale":{"type":"string","description":"Node name path translation","example":null},"countryCode":{"type":"string","description":"Two-letter country code","example":null},"currency":{"type":"string","description":"Currency type for this market","example":null},"totalProducts":{"type":"integer","description":"Total product count","example":1},"products":{"type":"integer","description":"Sample product count","example":1},"sellers":{"type":"integer","description":"Seller count","example":1},"brands":{"type":"integer","description":"Brand count","example":1},"avgSellers":{"type":"number","description":"Average seller count","example":1},"hlProducts":{"type":"integer","description":"Top N Listing sample product count","example":1},"avgUnits":{"type":"integer","description":"Average monthly sales volume","example":1},"avgRevenue":{"type":"number","description":"Average monthly sales revenue","example":1},"avgPrice":{"type":"number","description":"Average price","example":1},"avgRating":{"type":"number","description":"Average star rating","example":1},"avgRatings":{"type":"integer","description":"Average review count","example":1},"avgRatingsCv":{"type":"integer","description":"Average monthly review growth count","example":1},"avgBsr":{"type":"integer","description":"Average BSR","example":1},"avgProfit":{"type":"number","description":"Average profit margin","example":1},"avgWeight":{"type":"number","description":"Average weight (pound)","example":1},"baseAvgWeight":{"type":"number","description":"Average weight (g)","example":1},"avgVolume":{"type":"number","description":"Average volume (in³)","example":1},"baseAvgVolume":{"type":"number","description":"Average volume (cm³)","example":1},"hlAvgUnits":{"type":"integer","description":"Top N Listing average monthly sales volume","example":1},"hlAvgRevenue":{"type":"number","description":"Top N Listing average monthly sales revenue","example":1},"hlAvgPrice":{"type":"number","description":"Top N Listing average price","example":1},"hlAvgRating":{"type":"number","description":"Top N Listing average star rating","example":1},"hlAvgRatings":{"type":"integer","description":"Top N Listing average review count","example":1},"hlAvgRatingsCv":{"type":"integer","description":"Top N Listing average monthly review growth count","example":1},"hlAvgBsr":{"type":"integer","description":"Top N Listing average BSR","example":1},"newProducts":{"type":"integer","description":"New product count","example":1},"newProductProportion":{"type":"number","description":"New product share","example":1},"newAvgUnits":{"type":"integer","description":"New product average monthly sales volume","example":1},"newAvgRevenue":{"type":"number","description":"New product average monthly sales revenue","example":1},"newAvgPrice":{"type":"number","description":"New product average price","example":1},"newAvgRating":{"type":"number","description":"New product average star rating","example":1},"newAvgRatings":{"type":"integer","description":"New product average review count","example":1},"minNewRatings":{"type":"integer","description":"Minimum new product review count","example":1},"maxNewRatings":{"type":"integer","description":"Maximum new product review count","example":1},"firstShelfDate":{"type":"string","description":"Product first listing date","example":"2026-01-01"},"lastShelfDate":{"type":"string","description":"Product latest listing date","example":"2026-01-01"}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render columns","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"marketplace":"US","data":[{"marketplace":"US","totalProducts":1,"products":1,"sellers":1,"brands":1,"avgSellers":1,"hlProducts":1,"avgUnits":1,"avgRevenue":1,"avgPrice":1,"avgRating":1,"avgRatings":1,"avgRatingsCv":1,"avgBsr":1,"avgProfit":1,"avgWeight":1,"baseAvgWeight":1,"avgVolume":1,"baseAvgVolume":1,"hlAvgUnits":1,"hlAvgRevenue":1,"hlAvgPrice":1,"hlAvgRating":1,"hlAvgRatings":1,"hlAvgRatingsCv":1,"hlAvgBsr":1,"newProducts":1,"newProductProportion":1,"newAvgUnits":1,"newAvgRevenue":1,"newAvgPrice":1,"newAvgRating":1,"newAvgRatings":1,"minNewRatings":1,"maxNewRatings":1,"firstShelfDate":"2026-01-01","lastShelfDate":"2026-01-01"}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-market-statistics","x-nexscope-mcp-tool-name":"nexscope_amazon_market_statistics","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-niche-info/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Niche Info","description":"Query and analyze Nexscope data for Amazon niche market insights, including market metrics, buyer reviews, competitive landscape, price trends, and growth trends. Trigger when the user mentions niche market analysis, market insights, niche market data, market competition analysis, brand concentration, new product launch success rate, out-of-stock rate, price trends, review insights, market demand score, niche market insights, market metrics, competition analysis, price trends, growth trends, Nexscope data, market intelligence, out-of-stock rate. Even if the user does not explicitly mention \"Nexscope\" or \"niche market\", if their need involves querying market-level intelligence for a specific Amazon niche market by market ID, this skill should also be triggered.","operationId":"runAmazonNicheInfo","externalDocs":{"description":"Amazon Niche Info documentation","url":"https://www.nexscope.ai/api-docs/amazon-niche-info"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-niche-info.","properties":{"nicheId":{"type":"string","description":"Niche market ID, max length 1000 characters, only supports single ID query","example":"dfecfecfa9701de73a08867d7bcd3bc0"},"countryCode":{"type":"string","description":"Country code, only supports US, JP, DE, default US"}},"required":["nicheId"],"example":{"countryCode":"US","nicheId":"dfecfecfa9701de73a08867d7bcd3bc0"},"additionalProperties":true},"example":{"countryCode":"US","nicheId":"dfecfecfa9701de73a08867d7bcd3bc0"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Record count","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Niche market information list, each element is an object containing the fields below","example":[],"items":{"type":"object","properties":{"nicheId":{"type":"string","description":"Niche market ID","example":"dfecfecfa9701de73a08867d7bcd3bc0"},"nicheTitle":{"type":"string","description":"Niche market title","example":null},"translationZh":{"type":"string","description":"Niche market title (Chinese)","example":null},"referenceAsinImageUrl":{"type":"string","description":"Niche market reference image URL","example":"B072MQ5BRX"},"marketplaceId":{"type":"string","description":"Market ID","example":"US"},"demand":{"type":"integer","description":"Niche market score","example":1},"categorieList":{"type":"array","description":"Product category list","example":[]},"productCount":{"type":"integer","description":"Product count","example":1},"productCountNow":{"type":"integer","description":"Product count (current)","example":1},"productCountT90Before":{"type":"integer","description":"Product count (90 days ago)","example":1},"productCountT360Before":{"type":"integer","description":"Product count (360 days ago)","example":1},"brandCount":{"type":"integer","description":"Brand count","example":1},"brandCountNow":{"type":"integer","description":"Brand count (current)","example":1},"brandCountT90Before":{"type":"integer","description":"Brand count (90 days ago)","example":1},"brandCountT360Before":{"type":"integer","description":"Brand count (360 days ago)","example":1},"brandCountT360Now":{"type":"integer","description":"Brand count (360-day stats) (current)","example":1},"brandCountT360T90Before":{"type":"integer","description":"Brand count (360-day stats) (90 days ago)","example":1},"brandCountT360T360Before":{"type":"integer","description":"Brand count (360-day stats) (360 days ago)","example":1},"sellingPartnerCountNow":{"type":"integer","description":"Selling partner count (current)","example":1},"sellingPartnerCountT90Before":{"type":"integer","description":"Selling partner count (90 days ago)","example":1},"sellingPartnerCountT360Before":{"type":"integer","description":"Selling partner count (360 days ago)","example":1},"sellingPartnerCountT360Now":{"type":"integer","description":"Selling partner count (360-day stats) (current)","example":1},"sellingPartnerCountT360T90Before":{"type":"integer","description":"Selling partner count (360-day stats) (90 days ago)","example":1},"sellingPartnerCountT360T360Before":{"type":"integer","description":"Selling partner count (360-day stats) (360 days ago)","example":1},"avgPrice":{"type":"number","description":"Average product price","example":1},"avgProductPriceNow":{"type":"number","description":"Average product price (current)","example":1},"avgProductPriceT90Before":{"type":"number","description":"Average product price (90 days ago)","example":1},"avgProductPriceT360Before":{"type":"number","description":"Average product price (360 days ago)","example":1},"minimumPrice":{"type":"number","description":"Lowest product price","example":1},"maximumPrice":{"type":"number","description":"Highest product price","example":1},"searchVolumeWeekly":{"type":"integer","description":"Search volume (weekly data)","example":1},"searchVolumeQuarterly":{"type":"integer","description":"Search volume (quarterly data)","example":1},"searchVolumeGrowthWeekly":{"type":"number","description":"Search volume growth rate (weekly data)","example":1},"searchVolumeGrowthQuarterly":{"type":"number","description":"Search volume growth rate (quarterly data)","example":1},"searchConversionRateWeekly":{"type":"number","description":"Search conversion rate (weekly data)","example":1},"searchConversionRateQuarterly":{"type":"number","description":"Search conversion rate (quarterly data)","example":1},"clickCountWeekly":{"type":"integer","description":"Click volume (weekly data)","example":1},"clickCountQuarterly":{"type":"integer","description":"Click volume (quarterly data)","example":1},"clickConversionRateQuarterly":{"type":"number","description":"Click conversion rate (quarterly data)","example":1},"clickToSaleConversionWeekly":{"type":"number","description":"Click conversion rate (weekly data)","example":1},"unitsSoldWeekly":{"type":"integer","description":"Sales volume (weekly data)","example":1},"unitsSoldQuarterly":{"type":"integer","description":"Sales volume (quarterly data)","example":1},"top5ProductsClickShare":{"type":"number","description":"Top 5 products click share","example":1},"top5ProductsClickShareNow":{"type":"number","description":"Top 5 products' click share in the niche market (current)","example":1},"top5ProductsClickShareT90Before":{"type":"number","description":"Top 5 products' click share in the niche market (90 days ago)","example":1},"top5ProductsClickShareT360Before":{"type":"number","description":"Top 5 products' click share in the niche market (360 days ago)","example":1},"top5ProductsClickShareT360Now":{"type":"number","description":"Top 5 products click share (360-day stats) (current)","example":1},"top5ProductsClickShareT360T90Before":{"type":"number","description":"Top 5 products click share (360-day stats) (90 days ago)","example":1},"top5ProductsClickShareT360T360Before":{"type":"number","description":"Top 5 products click share (360-day stats) (360 days ago)","example":1},"top20ProductsClickShareNow":{"type":"number","description":"Top 20 products' click share in the niche market (current)","example":1},"top20ProductsClickShareT90Before":{"type":"number","description":"Top 20 products' click share in the niche market (90 days ago)","example":1},"top20ProductsClickShareT360Before":{"type":"number","description":"Top 20 products' click share in the niche market (360 days ago)","example":1},"top20ProductsClickShareT360Now":{"type":"number","description":"Top 20 products click share (360-day stats) (current)","example":1},"top20ProductsClickShareT360T90Before":{"type":"number","description":"Top 20 products click share (360-day stats) (90 days ago)","example":1},"top20ProductsClickShareT360T360Before":{"type":"number","description":"Top 20 products click share (360-day stats) (360 days ago)","example":1},"top5BrandsClickShare":{"type":"number","description":"Top 5 brands' click share in the niche market","example":1},"top5BrandsClickShareNow":{"type":"number","description":"Top 5 brands' click share in the niche market (current)","example":1},"top5BrandsClickShareT90Before":{"type":"number","description":"Top 5 brands' click share in the niche market (90 days ago)","example":1},"top5BrandsClickShareT360Before":{"type":"number","description":"Top 5 brands' click share in the niche market (360 days ago)","example":1},"top5BrandsClickShareT360Now":{"type":"number","description":"Top 5 brands' click share in the niche market (360-day stats) (current)","example":1},"top5BrandsClickShareT360T90Before":{"type":"number","description":"Top 5 brands' click share in the niche market (360-day stats) (90 days ago)","example":1},"top5BrandsClickShareT360T360Before":{"type":"number","description":"Top 5 brands' click share in the niche market (360-day stats) (360 days ago)","example":1},"top20BrandsClickShareNow":{"type":"number","description":"Top 20 brands' click share in the niche market (current)","example":1},"top20BrandsClickShareT90Before":{"type":"number","description":"Top 20 brands' click share in the niche market (90 days ago)","example":1},"top20BrandsClickShareT360Before":{"type":"number","description":"Top 20 brands' click share in the niche market (360 days ago)","example":1},"top20BrandsClickShareT360Now":{"type":"number","description":"Top 20 brands' click share in the niche market (360-day stats) (current)","example":1},"top20BrandsClickShareT360T90Before":{"type":"number","description":"Top 20 brands' click share in the niche market (360-day stats) (90 days ago)","example":1},"top20BrandsClickShareT360T360Before":{"type":"number","description":"Top 20 brands' click share in the niche market (360-day stats) (360 days ago)","example":1},"newProductsLaunchedSemiannual":{"type":"integer","description":"Number of new products launched (semi-annual data)","example":1},"newProductsLaunchedT180Now":{"type":"integer","description":"Number of new products launched (180-day stats) (current)","example":1},"newProductsLaunchedT180T90Before":{"type":"integer","description":"Number of new products launched (180-day stats) (90 days ago)","example":1},"newProductsLaunchedT180T360Before":{"type":"integer","description":"Number of new products launched (180-day stats) (360 days ago)","example":1},"newProductsLaunchedT360Now":{"type":"integer","description":"Number of newly listed products (360-day stats) (current)","example":1},"newProductsLaunchedT360T90Before":{"type":"integer","description":"Number of newly listed products (360-day stats) (90 days ago)","example":1},"newProductsLaunchedT360T360Before":{"type":"integer","description":"Number of newly listed products (360-day stats) (360 days ago)","example":1},"successfulLaunchedSemiannual":{"type":"integer","description":"Number of successfully launched products (semi-annual data)","example":1},"launchRateSemiannual":{"type":"number","description":"Product launch success rate (semi-annual data)","example":1},"successfulLaunchesT90Now":{"type":"integer","description":"Successfully launched count (90-day stats) (current)","example":1},"successfulLaunchesT90T90Before":{"type":"integer","description":"Successfully launched count (90-day stats) (90 days ago)","example":1},"successfulLaunchesT90T360Before":{"type":"integer","description":"Successfully launched count (90-day stats) (360 days ago)","example":1},"successfulLaunchesT180Now":{"type":"integer","description":"Number of successfully launched products (180-day stats) (current)","example":1},"successfulLaunchesT180T90Before":{"type":"integer","description":"Number of successfully launched products (180-day stats) (90 days ago)","example":1},"successfulLaunchesT180T360Before":{"type":"integer","description":"Number of successfully launched products (180-day stats) (360 days ago)","example":1},"successfulLaunchesT360Now":{"type":"integer","description":"Number of successfully launched products (360-day stats) (current)","example":1},"successfulLaunchesT360T90Before":{"type":"integer","description":"Number of successfully launched products (360-day stats) (90 days ago)","example":1},"successfulLaunchesT360T360Before":{"type":"integer","description":"Number of successfully launched products (360-day stats) (360 days ago)","example":1},"avgOOSRateNow":{"type":"number","description":"Average out-of-stock rate (current)","example":1},"avgOOSRateT90Before":{"type":"number","description":"Average out-of-stock rate (90 days ago)","example":1},"avgOOSRateT360Before":{"type":"number","description":"Average out-of-stock rate (360 days ago)","example":1},"avgOOSRateT360Now":{"type":"number","description":"Average out-of-stock rate (360-day stats) (current)","example":1},"avgOOSRateT360T90Before":{"type":"number","description":"Average out-of-stock rate (360-day stats) (90 days ago)","example":1},"avgOOSRateT360T360Before":{"type":"number","description":"Average out-of-stock rate (360-day stats) (360 days ago)","example":1},"primeProductsPercentageNow":{"type":"number","description":"Prime product percentage (current)","example":1},"primeProductsPercentageT90Before":{"type":"number","description":"Prime product percentage (90 days ago)","example":1},"primeProductsPercentageT360Before":{"type":"number","description":"Prime product percentage (360 days ago)","example":1},"primeProductsPercentageT360Now":{"type":"number","description":"Prime product percentage (360-day stats) (current)","example":1},"primeProductsPercentageT360T90Before":{"type":"number","description":"Prime product percentage (360-day stats) (90 days ago)","example":1},"primeProductsPercentageT360T360Before":{"type":"number","description":"Prime product percentage (360-day stats) (360 days ago)","example":1},"avgReviewRatingNow":{"type":"number","description":"Average review rating (current)","example":1},"avgReviewRatingT90Before":{"type":"number","description":"Average review rating (90 days ago)","example":1},"avgReviewRatingT360Before":{"type":"number","description":"Average review rating (360 days ago)","example":1},"avgReviewCountNow":{"type":"number","description":"Average review count (current)","example":1},"avgReviewCountT90Before":{"type":"number","description":"Average review count (90 days ago)","example":1},"avgReviewCountT360Before":{"type":"number","description":"Average review count (360 days ago)","example":1},"positiveCustomerReviewInsights":{"type":"array","description":"Positive customer review insights","example":[]},"negativeCustomerReviewInsights":{"type":"array","description":"Negative customer review insights","example":[]},"productStarRatingImpact":{"type":"array","description":"Product star rating impact information","example":[]},"avgBrandAgeNow":{"type":"number","description":"Average brand age (current)","example":1},"avgBrandAgeT90Before":{"type":"number","description":"Average brand age (90 days ago)","example":1},"avgBrandAgeT360Before":{"type":"number","description":"Average brand age (360 days ago)","example":1},"avgBrandAgeQuarterly":{"type":"number","description":"Average brand age (quarterly data)","example":1},"avgBrandAgeT360Now":{"type":"number","description":"Average brand age (360-day stats) (current)","example":1},"avgBrandAgeT360T90Before":{"type":"number","description":"Average brand age (360-day stats) (90 days ago)","example":1},"avgBrandAgeT360T360Before":{"type":"number","description":"Average brand age (360-day stats) (360 days ago)","example":1},"avgSellingPartnerAgeNow":{"type":"number","description":"Average selling partner age (current)","example":1},"avgSellingPartnerAgeT90Before":{"type":"number","description":"Average selling partner age (90 days ago)","example":1},"avgSellingPartnerAgeT360Before":{"type":"number","description":"Average selling partner age (360 days ago)","example":1},"avgBestSellerRankNow":{"type":"number","description":"Average Best Seller rank (current)","example":1},"avgBestSellerRankT90Before":{"type":"number","description":"Average Best Seller rank (90 days ago)","example":1},"avgBestSellerRankT360Before":{"type":"number","description":"Average Best Seller rank (360 days ago)","example":1},"acos":{"type":"number","description":"(ACOS) Advertising Cost of Sale","example":1},"sponsoredProductsPercentageNow":{"type":"number","description":"Percentage of products with Sponsored Products ads (current)","example":1},"sponsoredProductsPercentageT90Before":{"type":"number","description":"Percentage of products with Sponsored Products ads (90 days ago)","example":1},"sponsoredProductsPercentageT360Before":{"type":"number","description":"Percentage of products with Sponsored Products ads (360 days ago)","example":1},"sponsoredProductsPercentageT360Now":{"type":"number","description":"Percentage of products with Sponsored Products ads (360-day stats) (current)","example":1},"sponsoredProductsPercentageT360T90Before":{"type":"number","description":"Percentage of products with Sponsored Products ads (360-day stats) (90 days ago)","example":1},"sponsoredProductsPercentageT360T360Before":{"type":"number","description":"Percentage of products with Sponsored Products ads (360-day stats) (360 days ago)","example":1},"profitMarginGt50PctSkuRatio":{"type":"number","description":"Proportion of products with profit margin > 50%","example":1},"breakEvenRatio":{"type":"number","description":"Break-even ratio","example":1},"returnRateAnnual":{"type":"number","description":"Return rate (annual data)","example":1},"cpc":{"type":"object","description":"CPC (Cost Per Click) data","example":{}}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render columns","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"nicheId":"dfecfecfa9701de73a08867d7bcd3bc0","referenceAsinImageUrl":"B072MQ5BRX","marketplaceId":"US","demand":1,"categorieList":[],"productCount":1,"productCountNow":1,"productCountT90Before":1,"productCountT360Before":1,"brandCount":1,"brandCountNow":1,"brandCountT90Before":1,"brandCountT360Before":1,"brandCountT360Now":1,"brandCountT360T90Before":1,"brandCountT360T360Before":1,"sellingPartnerCountNow":1,"sellingPartnerCountT90Before":1,"sellingPartnerCountT360Before":1,"sellingPartnerCountT360Now":1,"sellingPartnerCountT360T90Before":1,"sellingPartnerCountT360T360Before":1,"avgPrice":1,"avgProductPriceNow":1,"avgProductPriceT90Before":1,"avgProductPriceT360Before":1,"minimumPrice":1,"maximumPrice":1,"searchVolumeWeekly":1,"searchVolumeQuarterly":1,"searchVolumeGrowthWeekly":1,"searchVolumeGrowthQuarterly":1,"searchConversionRateWeekly":1,"searchConversionRateQuarterly":1,"clickCountWeekly":1,"clickCountQuarterly":1,"clickConversionRateQuarterly":1,"clickToSaleConversionWeekly":1,"unitsSoldWeekly":1,"unitsSoldQuarterly":1,"top5ProductsClickShare":1,"top5ProductsClickShareNow":1,"top5ProductsClickShareT90Before":1,"top5ProductsClickShareT360Before":1,"top5ProductsClickShareT360Now":1,"top5ProductsClickShareT360T90Before":1,"top5ProductsClickShareT360T360Before":1,"top20ProductsClickShareNow":1,"top20ProductsClickShareT90Before":1,"top20ProductsClickShareT360Before":1,"top20ProductsClickShareT360Now":1,"top20ProductsClickShareT360T90Before":1,"top20ProductsClickShareT360T360Before":1,"top5BrandsClickShare":1,"top5BrandsClickShareNow":1,"top5BrandsClickShareT90Before":1,"top5BrandsClickShareT360Before":1,"top5BrandsClickShareT360Now":1,"top5BrandsClickShareT360T90Before":1,"top5BrandsClickShareT360T360Before":1,"top20BrandsClickShareNow":1,"top20BrandsClickShareT90Before":1,"top20BrandsClickShareT360Before":1,"top20BrandsClickShareT360Now":1,"top20BrandsClickShareT360T90Before":1,"top20BrandsClickShareT360T360Before":1,"newProductsLaunchedSemiannual":1,"newProductsLaunchedT180Now":1,"newProductsLaunchedT180T90Before":1,"newProductsLaunchedT180T360Before":1,"newProductsLaunchedT360Now":1,"newProductsLaunchedT360T90Before":1,"newProductsLaunchedT360T360Before":1,"successfulLaunchedSemiannual":1,"launchRateSemiannual":1,"successfulLaunchesT90Now":1,"successfulLaunchesT90T90Before":1,"successfulLaunchesT90T360Before":1,"successfulLaunchesT180Now":1,"successfulLaunchesT180T90Before":1,"successfulLaunchesT180T360Before":1,"successfulLaunchesT360Now":1,"successfulLaunchesT360T90Before":1,"successfulLaunchesT360T360Before":1,"avgOOSRateNow":1,"avgOOSRateT90Before":1,"avgOOSRateT360Before":1,"avgOOSRateT360Now":1,"avgOOSRateT360T90Before":1,"avgOOSRateT360T360Before":1,"primeProductsPercentageNow":1,"primeProductsPercentageT90Before":1,"primeProductsPercentageT360Before":1,"primeProductsPercentageT360Now":1,"primeProductsPercentageT360T90Before":1,"primeProductsPercentageT360T360Before":1,"avgReviewRatingNow":1,"avgReviewRatingT90Before":1,"avgReviewRatingT360Before":1,"avgReviewCountNow":1,"avgReviewCountT90Before":1,"avgReviewCountT360Before":1,"positiveCustomerReviewInsights":[],"negativeCustomerReviewInsights":[],"productStarRatingImpact":[],"avgBrandAgeNow":1,"avgBrandAgeT90Before":1,"avgBrandAgeT360Before":1,"avgBrandAgeQuarterly":1,"avgBrandAgeT360Now":1,"avgBrandAgeT360T90Before":1,"avgBrandAgeT360T360Before":1,"avgSellingPartnerAgeNow":1,"avgSellingPartnerAgeT90Before":1,"avgSellingPartnerAgeT360Before":1,"avgBestSellerRankNow":1,"avgBestSellerRankT90Before":1,"avgBestSellerRankT360Before":1,"acos":1,"sponsoredProductsPercentageNow":1,"sponsoredProductsPercentageT90Before":1,"sponsoredProductsPercentageT360Before":1,"sponsoredProductsPercentageT360Now":1,"sponsoredProductsPercentageT360T90Before":1,"sponsoredProductsPercentageT360T360Before":1,"profitMarginGt50PctSkuRatio":1,"breakEvenRatio":1,"returnRateAnnual":1,"cpc":{}}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-niche-info","x-nexscope-mcp-tool-name":"nexscope_amazon_niche_info","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-niche-info-by-asin/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Niche Info By Asin","description":"Deep analysis of Amazon niche markets by product ASIN, covering monopoly level, brand concentration, new product success rate, and market opportunity score. Trigger when the user mentions niche market analysis by ASIN, ASIN market research, ASIN niche lookup, monopoly assessment, brand concentration analysis, new product success rate, market demand score, competitive landscape, Amazon sub-market exploration, ASIN niche analysis, niche by ASIN, monopoly level, brand concentration, new product success rate, market opportunity score, competitive landscape, Nexscope data. Even if the user does not explicitly mention \"niche market\" or \"ASIN\", if their need involves evaluating the competitive landscape, brand density, or opportunity potential of the niche segment a specific product ASIN belongs to, this skill should also be triggered.","operationId":"runAmazonNicheInfoByAsin","externalDocs":{"description":"Amazon Niche Info By Asin documentation","url":"https://www.nexscope.ai/api-docs/amazon-niche-info-by-asin"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-niche-info-by-asin.","properties":{"asin":{"type":"string","description":"Product ASIN (required). The tool will find market segments that share the same niche as this ASIN","example":"B072MQ5BRX"},"countryCode":{"type":"string","description":"Country code, options: US (United States), JP (Japan), DE (Germany)"},"count":{"type":"integer","description":"Number of niche markets returned","example":1},"productCountMin":{"type":"integer","description":"Minimum product count (current)","example":1},"productCountMax":{"type":"integer","description":"Maximum product count (current)","example":1},"avgPriceMin":{"type":"number","description":"Minimum average price (current)","example":1},"avgPriceMax":{"type":"number","description":"Maximum average price (current)","example":1},"searchVolumeT7Min":{"type":"integer","description":"Minimum search volume (7-day stats)","example":1},"searchVolumeT7Max":{"type":"integer","description":"Maximum search volume (7-day stats)","example":1},"unitsSoldT7Min":{"type":"integer","description":"Minimum sales volume (7-day stats)","example":1},"unitsSoldT7Max":{"type":"integer","description":"Maximum sales volume (7-day stats)","example":1},"clickCountT7Min":{"type":"integer","description":"Minimum click volume (7-day stats)","example":1},"clickCountT7Max":{"type":"integer","description":"Maximum click volume (7-day stats)","example":1},"clickConversionRateT7Min":{"type":"number","description":"Minimum click conversion rate (7-day stats), range 0-1, 0.1 means 10% conversion rate","example":1},"clickConversionRateT7Max":{"type":"number","description":"Maximum click conversion rate (7-day stats), range 0-1, 0.1 means 10% conversion rate","example":1},"brandCountMin":{"type":"integer","description":"Minimum brand count","example":1},"brandCountMax":{"type":"integer","description":"Maximum brand count","example":1},"top5BrandsClickShareMin":{"type":"number","description":"Minimum top 5 brands' click share in the niche market, range 0-1, 0.1 means 10% click share","example":1},"top5BrandsClickShareMax":{"type":"number","description":"Maximum top 5 brands' click share in the niche market, range 0-1, 0.1 means 10% click share","example":1},"avgBrandAgeMin":{"type":"number","description":"Minimum average brand age (current)","example":1},"avgBrandAgeMax":{"type":"number","description":"Maximum average brand age (current)","example":1},"avgBrandAgeQoqMin":{"type":"number","description":"Minimum average brand age (90-day stats)","example":1},"avgBrandAgeQoqMax":{"type":"number","description":"Maximum average brand age (90-day stats)","example":1},"avgBrandAgeYoyMin":{"type":"number","description":"Minimum average brand age (360-day stats)","example":1},"avgBrandAgeYoyMax":{"type":"number","description":"Maximum average brand age (360-day stats)","example":1},"avgSellingPartnerAgeMin":{"type":"number","description":"Minimum average selling partner age","example":1},"avgSellingPartnerAgeMax":{"type":"number","description":"Maximum average selling partner age","example":1},"avgSellingPartnerAgeQoqMin":{"type":"number","description":"Minimum average selling partner age (90-day stats)","example":1},"avgSellingPartnerAgeQoqMax":{"type":"number","description":"Maximum average selling partner age (90-day stats)","example":1},"avgSellingPartnerAgeYoyMin":{"type":"number","description":"Minimum average selling partner age (360-day stats)","example":1},"avgSellingPartnerAgeYoyMax":{"type":"number","description":"Maximum average selling partner age (360-day stats)","example":1},"top5ProductsClickShareMin":{"type":"number","description":"Minimum top 5 products click share (current), range 0-1, 0.1 means 10% click share","example":1},"top5ProductsClickShareMax":{"type":"number","description":"Maximum top 5 products click share (current), range 0-1, 0.1 means 10% click share","example":1},"sponsoredProductsPercentageMin":{"type":"number","description":"Minimum SP ad share, range 0-1, 0.1 means 10%","example":1},"sponsoredProductsPercentageMax":{"type":"number","description":"Maximum SP ad share, range 0-1, 0.1 means 10%","example":1},"cpcMediumMin":{"type":"number","description":"Minimum CPC (current)","example":1},"cpcMediumMax":{"type":"number","description":"Maximum CPC (current)","example":1},"launchRateT180Min":{"type":"number","description":"Minimum product launch success rate (180-day stats), range 0-1, 0.1 means 10% success rate","example":1},"launchRateT180Max":{"type":"number","description":"Maximum product launch success rate (180-day stats), range 0-1, 0.1 means 10% success rate","example":1},"returnRateT360Min":{"type":"number","description":"Minimum return rate (360-day stats), range 0-1, 0.1 means 10% return rate","example":1},"returnRateT360Max":{"type":"number","description":"Maximum return rate (360-day stats), range 0-1, 0.1 means 10% return rate","example":1}},"required":["asin"],"example":{"countryCode":"US","count":10,"asin":"B072MQ5BRX"},"additionalProperties":true},"example":{"countryCode":"US","count":10,"asin":"B072MQ5BRX"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"nicheInfoVoList":{"anyOf":[{"type":"array","description":"Niche market information list (see niche market object fields below)","example":[],"items":{"type":"object","properties":{"nicheId":{"type":"string","description":"Niche market ID","example":"example-id"},"nicheTitle":{"type":"string","description":"Niche market title","example":null},"translationZh":{"type":"string","description":"Niche market title (Chinese)","example":null},"demand":{"type":"integer","description":"Niche market score","example":1},"productCount":{"type":"integer","description":"Product count","example":1},"avgPrice":{"type":"number","description":"Average product price","example":1},"minimumPrice":{"type":"number","description":"Lowest product price","example":1},"maximumPrice":{"type":"number","description":"Highest product price","example":1},"searchVolumeWeekly":{"type":"integer","description":"Search volume (weekly data)","example":1},"searchVolumeQuarterly":{"type":"integer","description":"Search volume (quarterly data)","example":1},"searchVolumeGrowthWeekly":{"type":"number","description":"Search volume growth rate (weekly data)","example":1},"searchVolumeGrowthQuarterly":{"type":"number","description":"Search volume growth rate (quarterly data)","example":1},"unitsSoldWeekly":{"type":"integer","description":"Sales volume (weekly data)","example":1},"unitsSoldQuarterly":{"type":"integer","description":"Sales volume (quarterly data)","example":1},"clickCountWeekly":{"type":"integer","description":"Click volume (weekly data)","example":1},"clickCountQuarterly":{"type":"integer","description":"Click volume (quarterly data)","example":1},"clickToSaleConversionWeekly":{"type":"number","description":"Click conversion rate (weekly data)","example":1},"clickConversionRateQuarterly":{"type":"number","description":"Click conversion rate (quarterly data)","example":1},"searchConversionRateWeekly":{"type":"number","description":"Search conversion rate (weekly data)","example":1},"searchConversionRateQuarterly":{"type":"number","description":"Search conversion rate (quarterly data)","example":1},"brandCount":{"type":"integer","description":"Brand count","example":1},"top5BrandsClickShare":{"type":"number","description":"Top 5 brands' click share in the niche market","example":1},"top5ProductsClickShare":{"type":"number","description":"Top 5 products click share","example":1},"avgBrandAgeNow":{"type":"number","description":"Average brand age (current)","example":1},"avgBrandAgeQuarterly":{"type":"number","description":"Average brand age (quarterly data)","example":1},"newProductsLaunchedSemiannual":{"type":"integer","description":"Number of new products launched (semi-annual data)","example":1},"successfulLaunchedSemiannual":{"type":"integer","description":"Number of successfully launched products (semi-annual data)","example":1},"launchRateSemiannual":{"type":"number","description":"Product launch success rate (semi-annual data)","example":1},"returnRateAnnual":{"type":"number","description":"Return rate (annual data)","example":1},"acos":{"type":"number","description":"(ACOS) Advertising Cost of Sale","example":1},"profitMarginGt50PctSkuRatio":{"type":"number","description":"Proportion of products with profit margin > 50%","example":1},"breakEvenRatio":{"type":"number","description":"Break-even natural share","example":1},"cpc":{"type":"object","description":"CPC data: { high (maximum bid), medium (median bid), low (minimum bid) }","example":{}},"categorieList":{"type":"array","description":"Product category list","example":[]},"referenceAsinImageUrl":{"type":"string","description":"Niche market reference image URL","example":"B072MQ5BRX"}}}},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"costToken":1,"nicheInfoVoList":[{"nicheId":"example-id","demand":1,"productCount":1,"avgPrice":1,"minimumPrice":1,"maximumPrice":1,"searchVolumeWeekly":1,"searchVolumeQuarterly":1,"searchVolumeGrowthWeekly":1,"searchVolumeGrowthQuarterly":1,"unitsSoldWeekly":1,"unitsSoldQuarterly":1,"clickCountWeekly":1,"clickCountQuarterly":1,"clickToSaleConversionWeekly":1,"clickConversionRateQuarterly":1,"searchConversionRateWeekly":1,"searchConversionRateQuarterly":1,"brandCount":1,"top5BrandsClickShare":1,"top5ProductsClickShare":1,"avgBrandAgeNow":1,"avgBrandAgeQuarterly":1,"newProductsLaunchedSemiannual":1,"successfulLaunchedSemiannual":1,"launchRateSemiannual":1,"returnRateAnnual":1,"acos":1,"profitMarginGt50PctSkuRatio":1,"breakEvenRatio":1,"cpc":{},"categorieList":[],"referenceAsinImageUrl":"B072MQ5BRX"}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-niche-info-by-asin","x-nexscope-mcp-tool-name":"nexscope_amazon_niche_info_by_asin","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-niche-info-by-keyword/run":{"post":{"tags":["Keyword & Search Demand"],"summary":"Amazon Niche Info By Keyword","description":"Deep analysis of Amazon niche markets by keyword, covering monopoly level, brand concentration, new product success rate, and market opportunity score. Trigger when the user mentions niche market analysis, keyword market research, monopoly assessment, brand concentration analysis, new product success rate, market demand score, competitive landscape, Amazon sub-market exploration, niche market analysis, keyword market, monopoly level, brand concentration, new product success rate, market opportunity score, competitive landscape, Nexscope data. Even if the user does not explicitly mention \"niche market\", if their need involves evaluating the competitive landscape, brand density, or opportunity potential of the Amazon market at the keyword dimension level, this skill should also be triggered.","operationId":"runAmazonNicheInfoByKeyword","externalDocs":{"description":"Amazon Niche Info By Keyword documentation","url":"https://www.nexscope.ai/api-docs/amazon-niche-info-by-keyword"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-niche-info-by-keyword.","properties":{"keyword":{"type":"string","description":"Keyword (required, translate the keyword to the corresponding country's language based on the selected country), max length 1000 characters","example":"phone case"},"countryCode":{"type":"string","description":"Country code, options: US (United States), JP (Japan), DE (Germany)"},"page":{"type":"integer","description":"Page number (starting from 1)","example":1},"pageSize":{"type":"integer","description":"Results per page (10-100)","example":10},"sortField":{"type":"string","description":"Sort field (see sort options below)"},"sortType":{"type":"string","description":"Sort direction: desc (descending) or asc (ascending)"},"productCountMin":{"type":"integer","description":"Minimum product count (current)","example":1},"productCountMax":{"type":"integer","description":"Maximum product count (current)","example":1},"avgPriceMin":{"type":"number","description":"Minimum average price (current)","example":1},"avgPriceMax":{"type":"number","description":"Maximum average price (current)","example":1},"searchVolumeT7Min":{"type":"integer","description":"Minimum search volume (7-day stats)","example":1},"searchVolumeT7Max":{"type":"integer","description":"Maximum search volume (7-day stats)","example":1},"unitsSoldT7Min":{"type":"integer","description":"Minimum sales volume (7-day stats)","example":1},"unitsSoldT7Max":{"type":"integer","description":"Maximum sales volume (7-day stats)","example":1},"clickCountT7Min":{"type":"integer","description":"Minimum click volume (7-day stats)","example":1},"clickCountT7Max":{"type":"integer","description":"Maximum click volume (7-day stats)","example":1},"clickConversionRateT7Min":{"type":"number","description":"Minimum click conversion rate (7-day stats), range 0-1, representing 0%-100%","example":1},"clickConversionRateT7Max":{"type":"number","description":"Maximum click conversion rate (7-day stats), range 0-1, representing 0%-100%","example":1},"brandCountMin":{"type":"integer","description":"Minimum brand count","example":1},"brandCountMax":{"type":"integer","description":"Maximum brand count","example":1},"top5BrandsClickShareMin":{"type":"number","description":"Minimum top 5 brands' click share in the niche market, range 0-1, representing 0%-100%","example":1},"top5BrandsClickShareMax":{"type":"number","description":"Maximum top 5 brands' click share in the niche market, range 0-1, representing 0%-100%","example":1},"avgBrandAgeMin":{"type":"number","description":"Minimum average brand age (current)","example":1},"avgBrandAgeMax":{"type":"number","description":"Maximum average brand age (current)","example":1},"avgBrandAgeQoqMin":{"type":"number","description":"Minimum average brand age (90-day stats)","example":1},"avgBrandAgeQoqMax":{"type":"number","description":"Maximum average brand age (90-day stats)","example":1},"avgBrandAgeYoyMin":{"type":"number","description":"Minimum average brand age (360-day stats)","example":1},"avgBrandAgeYoyMax":{"type":"number","description":"Maximum average brand age (360-day stats)","example":1},"avgSellingPartnerAgeMin":{"type":"number","description":"Minimum average selling partner age","example":1},"avgSellingPartnerAgeMax":{"type":"number","description":"Maximum average selling partner age","example":1},"avgSellingPartnerAgeQoqMin":{"type":"number","description":"Minimum average selling partner age (90-day stats)","example":1},"avgSellingPartnerAgeQoqMax":{"type":"number","description":"Maximum average selling partner age (90-day stats)","example":1},"avgSellingPartnerAgeYoyMin":{"type":"number","description":"Minimum average selling partner age (360-day stats)","example":1},"avgSellingPartnerAgeYoyMax":{"type":"number","description":"Maximum average selling partner age (360-day stats)","example":1},"top5ProductsClickShareMin":{"type":"number","description":"Minimum top 5 products click share (current), range 0-1, representing 0%-100%","example":1},"top5ProductsClickShareMax":{"type":"number","description":"Maximum top 5 products click share (current), range 0-1, representing 0%-100%","example":1},"sponsoredProductsPercentageMin":{"type":"number","description":"Minimum SP ad share, range 0-1, representing 0%-100%","example":1},"sponsoredProductsPercentageMax":{"type":"number","description":"Maximum SP ad share, range 0-1, representing 0%-100%","example":1},"cpcMediumMin":{"type":"number","description":"Minimum CPC (current)","example":1},"cpcMediumMax":{"type":"number","description":"Maximum CPC (current)","example":1},"launchRateT180Min":{"type":"number","description":"Minimum product launch success rate (180-day stats), range 0-1, representing 0%-100%","example":1},"launchRateT180Max":{"type":"number","description":"Maximum product launch success rate (180-day stats), range 0-1, representing 0%-100%","example":1},"newProductRateT180":{"type":"number","description":"Minimum new product share (180-day stats), range 0-1, representing 0%-100%","example":1},"returnRateT360Min":{"type":"number","description":"Minimum return rate (360-day stats), range 0-1, representing 0%-100%","example":1},"returnRateT360Max":{"type":"number","description":"Maximum return rate (360-day stats), range 0-1, representing 0%-100%","example":1}},"required":["keyword"],"example":{"page":1,"countryCode":"US","keyword":"phone case","pageSize":10},"additionalProperties":true},"example":{"page":1,"countryCode":"US","keyword":"phone case","pageSize":10}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total count","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Niche market information list (see niche market object fields below)","example":[],"items":{"type":"object","properties":{"nicheId":{"type":"string","description":"Niche market ID","example":"example-id"},"nicheTitle":{"type":"string","description":"Niche market title","example":null},"translationZh":{"type":"string","description":"Niche market title (Chinese)","example":null},"demand":{"type":"integer","description":"Niche market score","example":1},"productCount":{"type":"integer","description":"Product count","example":1},"avgPrice":{"type":"number","description":"Average product price","example":1},"minimumPrice":{"type":"number","description":"Lowest product price","example":1},"maximumPrice":{"type":"number","description":"Highest product price","example":1},"searchVolumeWeekly":{"type":"integer","description":"Search volume (weekly data)","example":1},"searchVolumeQuarterly":{"type":"integer","description":"Search volume (quarterly data)","example":1},"searchVolumeGrowthWeekly":{"type":"number","description":"Search volume growth rate (weekly data)","example":1},"searchVolumeGrowthQuarterly":{"type":"number","description":"Search volume growth rate (quarterly data)","example":1},"unitsSoldWeekly":{"type":"integer","description":"Sales volume (weekly data)","example":1},"unitsSoldQuarterly":{"type":"integer","description":"Sales volume (quarterly data)","example":1},"clickCountWeekly":{"type":"integer","description":"Click volume (weekly data)","example":1},"clickCountQuarterly":{"type":"integer","description":"Click volume (quarterly data)","example":1},"clickToSaleConversionWeekly":{"type":"number","description":"Click conversion rate (weekly data)","example":1},"clickConversionRateQuarterly":{"type":"number","description":"Click conversion rate (quarterly data)","example":1},"searchConversionRateWeekly":{"type":"number","description":"Search conversion rate (weekly data)","example":1},"searchConversionRateQuarterly":{"type":"number","description":"Search conversion rate (quarterly data)","example":1},"brandCount":{"type":"integer","description":"Brand count","example":1},"top5BrandsClickShare":{"type":"number","description":"Top 5 brands' click share in the niche market","example":1},"top5ProductsClickShare":{"type":"number","description":"Top 5 products click share","example":1},"avgBrandAgeNow":{"type":"number","description":"Average brand age (current)","example":1},"avgBrandAgeQuarterly":{"type":"number","description":"Average brand age (quarterly data)","example":1},"newProductsLaunchedSemiannual":{"type":"integer","description":"Number of new products launched (semi-annual data)","example":1},"successfulLaunchedSemiannual":{"type":"integer","description":"Number of successfully launched products (semi-annual data)","example":1},"launchRateSemiannual":{"type":"number","description":"Product launch success rate (semi-annual data)","example":1},"returnRateAnnual":{"type":"number","description":"Return rate (annual data)","example":1},"acos":{"type":"number","description":"(ACOS) Advertising Cost of Sale","example":1},"profitMarginGt50PctSkuRatio":{"type":"number","description":"Proportion of products with profit margin > 50%","example":1},"breakEvenRatio":{"type":"number","description":"Break-even ratio","example":1},"cpc":{"type":"object","description":"CPC data: { high (maximum bid), medium (median bid), low (minimum bid) }","example":{}},"categorieList":{"type":"array","description":"Product category list","example":[]},"referenceAsinImageUrl":{"type":"string","description":"Niche market reference image URL","example":"B072MQ5BRX"}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render columns","example":[]},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Title","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"nicheId":"example-id","demand":1,"productCount":1,"avgPrice":1,"minimumPrice":1,"maximumPrice":1,"searchVolumeWeekly":1,"searchVolumeQuarterly":1,"searchVolumeGrowthWeekly":1,"searchVolumeGrowthQuarterly":1,"unitsSoldWeekly":1,"unitsSoldQuarterly":1,"clickCountWeekly":1,"clickCountQuarterly":1,"clickToSaleConversionWeekly":1,"clickConversionRateQuarterly":1,"searchConversionRateWeekly":1,"searchConversionRateQuarterly":1,"brandCount":1,"top5BrandsClickShare":1,"top5ProductsClickShare":1,"avgBrandAgeNow":1,"avgBrandAgeQuarterly":1,"newProductsLaunchedSemiannual":1,"successfulLaunchedSemiannual":1,"launchRateSemiannual":1,"returnRateAnnual":1,"acos":1,"profitMarginGt50PctSkuRatio":1,"breakEvenRatio":1,"cpc":{},"categorieList":[],"referenceAsinImageUrl":"B072MQ5BRX"}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-niche-info-by-keyword","x-nexscope-mcp-tool-name":"nexscope_amazon_niche_info_by_keyword","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-niche-reviews-by-keyword/run":{"post":{"tags":["Keyword & Search Demand"],"summary":"Amazon Niche Reviews By Keyword","description":"Amazon niche market review analysis and consumer sentiment insights. Trigger when the user mentions niche market review analysis, consumer sentiment, user pain points, customer feedback insights, review topic analysis, positive/negative review breakdown, niche market opinion mining, product review sentiment analysis, niche market reviews, consumer sentiment, customer pain points, review topic analysis, positive/negative reviews, opinion mining, Nexscope data. Even if the user does not explicitly mention \"niche market reviews\", if their need involves analyzing consumer reviews within Amazon niche markets or understanding customer sentiment at the niche market level, this skill should also be triggered.","operationId":"runAmazonNicheReviewsByKeyword","externalDocs":{"description":"Amazon Niche Reviews By Keyword documentation","url":"https://www.nexscope.ai/api-docs/amazon-niche-reviews-by-keyword"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-niche-reviews-by-keyword.","properties":{"keyword":{"type":"string","description":"Keyword (required, use the language of the corresponding site, e.g. English for the US site, German for the Germany site), max length 1000 characters","example":"phone case"},"countryCode":{"type":"string","description":"Country code, options: US (United States), JP (Japan), DE (Germany)"},"page":{"type":"integer","description":"Page number (starting from 1)","example":1},"pageSize":{"type":"integer","description":"Results per page (10-100)","example":10},"sortField":{"type":"string","description":"Sort field, options: clickConversionRateT7 (7-day click conversion rate), demand (demand score), avgPrice (average product price), maximumPrice (highest product price), minimumPrice (lowest product price), productCount (product count), searchConversionRateT7 (7-day search conversion rate), searchVolumeT7 (7-day search volume), unitsSoldT7 (7-day sales volume), searchVolumeGrowthT7 (search growth rate), clickCountT90 (90-day click volume), clickCountT7 (weekly click volume), brandCount (brand count), top5BrandsClickShare (TOP5 brand share), newProductsLaunchedT180 (180-day new product success rate - launch count), successfulLaunchesT180 (180-day new product success rate - new product count), launchRateT180 (180-day new product success rate - launch rate), top5ProductsClickShare (top 5 product click share), returnRateT360 (return rate), clickConversionRateT90 (90-day click conversion rate), searchConversionRateT90 (90-day search conversion rate), searchVolumeT90 (90-day search volume), unitsSoldT90 (90-day sales volume), unitsSoldGrowthT90 (90-day sales growth rate), searchVolumeGrowthT90 (90-day search growth rate), acos, profitRate50 (profit rate for 50% natural orders)"},"sortType":{"type":"string","description":"Sort direction, options: desc (descending), asc (ascending)"},"productCountMin":{"type":"integer","description":"Minimum product count (current)","example":1},"productCountMax":{"type":"integer","description":"Maximum product count (current)","example":1},"brandCountMin":{"type":"integer","description":"Minimum brand count","example":1},"brandCountMax":{"type":"integer","description":"Maximum brand count","example":1},"avgPriceMin":{"type":"number","description":"Minimum average price (current)","example":1},"avgPriceMax":{"type":"number","description":"Maximum average price (current)","example":1},"unitsSoldT7Min":{"type":"integer","description":"Minimum sales volume (7-day stats)","example":1},"unitsSoldT7Max":{"type":"integer","description":"Maximum sales volume (7-day stats)","example":1},"searchVolumeT7Min":{"type":"integer","description":"Minimum search volume (7-day stats)","example":1},"searchVolumeT7Max":{"type":"integer","description":"Maximum search volume (7-day stats)","example":1},"clickCountT7Min":{"type":"integer","description":"Minimum click volume (7-day stats)","example":1},"clickCountT7Max":{"type":"integer","description":"Maximum click volume (7-day stats)","example":1},"clickConversionRateT7Min":{"type":"number","description":"Minimum click conversion rate (7-day stats)","example":1},"clickConversionRateT7Max":{"type":"number","description":"Maximum click conversion rate (7-day stats)","example":1},"top5BrandsClickShareMin":{"type":"number","description":"Minimum top 5 brands' click share in the niche market","example":1},"top5BrandsClickShareMax":{"type":"number","description":"Maximum top 5 brands' click share in the niche market","example":1},"top5ProductsClickShareMin":{"type":"number","description":"Minimum top 5 products click share (current)","example":1},"top5ProductsClickShareMax":{"type":"number","description":"Maximum top 5 products click share (current)","example":1},"sponsoredProductsPercentageMin":{"type":"number","description":"Minimum SP ad share","example":1},"sponsoredProductsPercentageMax":{"type":"number","description":"Maximum SP ad share","example":1},"avgBrandAgeMin":{"type":"number","description":"Minimum average brand age (current)","example":1},"avgBrandAgeMax":{"type":"number","description":"Maximum average brand age (current)","example":1},"avgBrandAgeQoqMin":{"type":"number","description":"Minimum average brand age (90-day stats)","example":1},"avgBrandAgeQoqMax":{"type":"number","description":"Maximum average brand age (90-day stats)","example":1},"avgBrandAgeYoyMin":{"type":"number","description":"Minimum average brand age (360-day stats)","example":1},"avgBrandAgeYoyMax":{"type":"number","description":"Maximum average brand age (360-day stats)","example":1},"avgSellingPartnerAgeMin":{"type":"number","description":"Minimum average selling partner age","example":1},"avgSellingPartnerAgeMax":{"type":"number","description":"Maximum average selling partner age","example":1},"avgSellingPartnerAgeQoqMin":{"type":"number","description":"Minimum average selling partner age (90-day stats)","example":1},"avgSellingPartnerAgeQoqMax":{"type":"number","description":"Maximum average selling partner age (90-day stats)","example":1},"avgSellingPartnerAgeYoyMin":{"type":"number","description":"Minimum average selling partner age (360-day stats)","example":1},"avgSellingPartnerAgeYoyMax":{"type":"number","description":"Maximum average selling partner age (360-day stats)","example":1},"launchRateT180Min":{"type":"number","description":"Minimum product launch success rate (180-day stats)","example":1},"launchRateT180Max":{"type":"number","description":"Maximum product launch success rate (180-day stats)","example":1},"newProductRateT180":{"type":"number","description":"Minimum new product share (180-day stats)","example":1},"returnRateT360Min":{"type":"number","description":"Minimum return rate (360-day stats)","example":1},"returnRateT360Max":{"type":"number","description":"Maximum return rate (360-day stats)","example":1},"cpcMediumMin":{"type":"number","description":"Minimum CPC (current)","example":1},"cpcMediumMax":{"type":"number","description":"Maximum CPC (current)","example":1}},"required":["keyword"],"example":{"page":1,"countryCode":"US","keyword":"phone case","pageSize":10},"additionalProperties":true},"example":{"page":1,"countryCode":"US","keyword":"phone case","pageSize":10}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total count","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Niche market review list (see data item fields below for details)","example":[],"items":{"type":"object","properties":{"nicheId":{"type":"string","description":"Niche market ID","example":"example-id"},"nicheName":{"type":"string","description":"Niche market name","example":null},"keyword":{"type":"string","description":"Keyword","example":"phone case"},"reviewType":{"type":"string","description":"Review type (values: [Positive Reviews], [Negative Reviews])","example":null},"topic":{"type":"string","description":"Review topic","example":null},"percentOfMentions":{"type":"number","description":"Share (range 0-1, representing 0%-100%)","example":1},"reviewExample":{"type":"string","description":"Review example","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render columns","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Title","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"nicheId":"example-id","keyword":"phone case","percentOfMentions":1}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-niche-reviews-by-keyword","x-nexscope-mcp-tool-name":"nexscope_amazon_niche_reviews_by_keyword","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-opportunity-report-by-keyword/run":{"post":{"tags":["Keyword & Search Demand"],"summary":"Amazon Opportunity Report By Keyword","description":"Query Amazon business insight reports by keyword, covering six dimensions: market potential, product characteristics, user reviews, customer profiles, search trends, and pricing analysis with AI-powered comprehensive analysis. Trigger when users mention Amazon business insights, market opportunity reports, product selection reports, competitive landscape, consumer profiles, pricing analysis, niche market research, or similar terms. Even if the user does not explicitly say \"business insights,\" trigger this skill whenever their request involves a comprehensive market opportunity assessment or report generation for an Amazon keyword.","operationId":"runAmazonOpportunityReportByKeyword","externalDocs":{"description":"Amazon Opportunity Report By Keyword documentation","url":"https://www.nexscope.ai/api-docs/amazon-opportunity-report-by-keyword"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-opportunity-report-by-keyword.","properties":{"site":{"type":"string","description":"Amazon site code, currently only supports US","example":"US"},"keyword":{"type":"string","description":"Search keyword for the insight report","example":"phone case"}},"required":["site","keyword"],"example":{"site":"US","keyword":"phone case"},"additionalProperties":true},"example":{"site":"US","keyword":"phone case"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"stdout":{"anyOf":[{"type":"string","description":"Comprehensive business insight report content (Markdown format), covering six dimensions: market potential, product features, user reviews, customer profiles, search trends, and pricing analysis","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Total processing time (milliseconds)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token consumption","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Response type","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-opportunity-report-by-keyword","x-nexscope-mcp-tool-name":"nexscope_amazon_opportunity_report_by_keyword","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-opportunity-search-by-metrics/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Opportunity Search By Metrics","description":"Amazon reverse product selection: filter Amazon niches and keywords by 30+ business dimensions (market size & growth, price tiers & share, competition density & top concentration, demographics such as age/gender/income, review highlights & pain points) from a metrics pool aggregated from historical business insight reports. Trigger when users mention reverse product selection, metrics filtering, niche reverse lookup, blue ocean niche discovery, low-competition niche, newcomer-friendly niche, brand-fragmented market, pain-point entry, feature reverse lookup, pricing tier opportunity, demographic-based selection, or similar terms. Even if the user does not explicitly say \"reverse product selection,\" trigger this skill whenever the request involves filtering Amazon niches that match specific business criteria.","operationId":"runAmazonOpportunitySearchByMetrics","externalDocs":{"description":"Amazon Opportunity Search By Metrics documentation","url":"https://www.nexscope.ai/api-docs/amazon-opportunity-search-by-metrics"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-opportunity-search-by-metrics.","properties":{"amazonDomain":{"type":"string","description":"Amazon site code (closed enum), currently only supports US. Defaults to US only if not specified"},"limit":{"type":"integer","description":"Maximum number of results to return (1-200), default 25. No page parameter; returns the most recent N records sorted by collection time descending","example":1},"keyword":{"type":"string","description":"Search keyword text fragment (LIKE fuzzy match)","example":"phone case"},"nicheName":{"type":"string","description":"Normalized niche name fragment (LIKE, snake_case lowercase), suitable for niche time-series comparison"},"nicheRevenue360dMinUsdAtLeastGte":{"type":"number","description":"Minimum 360-day market revenue lower bound (USD)","example":1},"nicheRevenue360dMinUsdAtLeastLte":{"type":"number","description":"Maximum 360-day market revenue lower bound (USD)","example":1},"nicheRevenue360dMaxUsdAtLeastGte":{"type":"number","description":"Minimum 360-day market revenue upper bound (USD)","example":1},"nicheRevenue360dMaxUsdAtLeastLte":{"type":"number","description":"Maximum 360-day market revenue upper bound (USD)","example":1},"nichePeakSearchVolumeAtLeastGte":{"type":"integer","description":"Peak monthly search volume minimum (non-negative integer)","example":1},"nichePeakSearchVolumeAtLeastLte":{"type":"integer","description":"Peak monthly search volume maximum (non-negative integer)","example":1},"nicheSearchVolumeYoyChangePctAtLeastGte":{"type":"number","description":"Search volume YoY change rate minimum (%, signed)","example":1},"nicheSearchVolumeYoyChangePctAtLeastLte":{"type":"number","description":"Search volume YoY change rate maximum (%, signed)","example":1},"nichePeakMonthGte":{"type":"integer","description":"Search peak month minimum (1-12)","example":1},"nichePeakMonthLte":{"type":"integer","description":"Search peak month maximum (1-12)","example":1},"nicheBrandCountGte":{"type":"integer","description":"Active brand count minimum","example":1},"nicheBrandCountLte":{"type":"integer","description":"Active brand count maximum","example":1},"nicheBrandCountYoyChangePctAtLeastGte":{"type":"number","description":"Brand count YoY change rate minimum (%, signed)","example":1},"nicheBrandCountYoyChangePctAtLeastLte":{"type":"number","description":"Brand count YoY change rate maximum (%, signed)","example":1},"nicheTop5ProductClickSharePctAtLeastGte":{"type":"number","description":"Top 5 product click share minimum (0-100)","example":1},"nicheTop5ProductClickSharePctAtLeastLte":{"type":"number","description":"Top 5 product click share maximum (0-100)","example":1},"featureTop5BrandSharePctAtLeastGte":{"type":"number","description":"Top 5 brand combined share minimum (0-100)","example":1},"featureTop5BrandSharePctAtLeastLte":{"type":"number","description":"Top 5 brand combined share maximum (0-100)","example":1},"featureTopBrandsContains":{"type":"string","description":"Top 3 brand name fragment (original text LIKE, case-sensitive)"},"priceMinUsdGte":{"type":"number","description":"Niche minimum product price lower bound (USD)","example":1},"priceMinUsdLte":{"type":"number","description":"Niche minimum product price upper bound (USD)","example":1},"priceMaxUsdGte":{"type":"number","description":"Niche maximum product price lower bound (USD)","example":1},"priceMaxUsdLte":{"type":"number","description":"Niche maximum product price upper bound (USD)","example":1},"priceSweetSpotMinUsdGte":{"type":"number","description":"Sweet spot lower bound minimum (USD)","example":1},"priceSweetSpotMinUsdLte":{"type":"number","description":"Sweet spot lower bound maximum (USD)","example":1},"priceSweetSpotMaxUsdGte":{"type":"number","description":"Sweet spot upper bound minimum (USD)","example":1},"priceSweetSpotMaxUsdLte":{"type":"number","description":"Sweet spot upper bound maximum (USD)","example":1},"priceEntryClickSharePctAtLeastGte":{"type":"number","description":"Entry tier click share minimum (0-100)","example":1},"priceEntryClickSharePctAtLeastLte":{"type":"number","description":"Entry tier click share maximum (0-100)","example":1},"priceMidClickSharePctAtLeastGte":{"type":"number","description":"Mid tier click share minimum (0-100)","example":1},"priceMidClickSharePctAtLeastLte":{"type":"number","description":"Mid tier click share maximum (0-100)","example":1},"priceHighClickSharePctAtLeastGte":{"type":"number","description":"High tier click share minimum (0-100)","example":1},"priceHighClickSharePctAtLeastLte":{"type":"number","description":"High tier click share maximum (0-100)","example":1},"demoPrimaryAgeMinGte":{"type":"integer","description":"Primary audience age lower bound minimum (0-120 years)","example":1},"demoPrimaryAgeMinLte":{"type":"integer","description":"Primary audience age lower bound maximum (0-120 years)","example":1},"demoPrimaryAgeMaxGte":{"type":"integer","description":"Primary audience age upper bound minimum (0-120 years)","example":1},"demoPrimaryAgeMaxLte":{"type":"integer","description":"Primary audience age upper bound maximum (0-120 years)","example":1},"demoGenderDominant":{"type":"string","description":"Dominant gender (closed enum): female / male / mixed / unspecified"},"demoPrimaryIncomeTier":{"type":"string","description":"Income tier (closed enum): low / middle_low / middle / middle_upper / upper_middle / high"},"demoLifeStageTagsContains":{"type":"string","description":"Life stage tag fragment (snake_case, LIKE): parent, student, retiree, athlete, etc."},"featureNewAvgReviewCountAtLeastGte":{"type":"integer","description":"New product average review count minimum (non-negative integer)","example":1},"featureNewAvgReviewCountAtLeastLte":{"type":"integer","description":"New product average review count maximum (non-negative integer)","example":1},"featureEstablishedAvgReviewCountAtLeastGte":{"type":"integer","description":"Established product average review count minimum (non-negative integer)","example":1},"featureEstablishedAvgReviewCountAtLeastLte":{"type":"integer","description":"Established product average review count maximum (non-negative integer)","example":1},"featureEmergingTrendTagsContains":{"type":"string","description":"Emerging trend feature tag fragment (snake_case, LIKE): cordless, portable, smart, etc."},"featureUncommonFeatureTagsContains":{"type":"string","description":"Rare differentiation feature tag fragment (snake_case, LIKE): hema_free, medical_grade_silicone, etc."},"searchTopCategory1Label":{"type":"string","description":"Search traffic top category 1 label fragment (snake_case, LIKE): core_product_terms, set_kit_configurations, etc."},"reviewPositiveTop1Topic":{"type":"string","description":"Positive review #1 topic fragment (snake_case, LIKE): comfort, quality_overall_generic, etc."},"reviewPositiveTop1PctAtLeastGte":{"type":"number","description":"Positive review #1 topic share minimum (0-100, share among positive reviews)","example":1},"reviewPositiveTop1PctAtLeastLte":{"type":"number","description":"Positive review #1 topic share maximum (0-100)","example":1},"reviewNegativeTop1Topic":{"type":"string","description":"Negative review #1 topic fragment (snake_case, LIKE): size, quality, durability, etc."},"reviewNegativeTop1PctAtLeastGte":{"type":"number","description":"Negative review #1 topic share minimum (0-100, share among negative reviews)","example":1},"reviewNegativeTop1PctAtLeastLte":{"type":"number","description":"Negative review #1 topic share maximum (0-100)","example":1},"reviewNegativeTop2Topic":{"type":"string","description":"Negative review #2 topic fragment (snake_case, LIKE)"},"reviewStrategicInsightTagsContains":{"type":"string","description":"Review strategic insight tag fragment (snake_case, LIKE): sizing_clarity, material_transparency, etc."}},"example":{"limit":10,"keyword":"phone case","amazonDomain":"US"},"additionalProperties":true},"example":{"limit":10,"keyword":"phone case","amazonDomain":"US"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"array","description":"Array of keyword metric records, each corresponding to a (site, keyword) combination, approximately 37 fields, sorted by collection time descending","example":[],"items":{"type":"object","properties":{"amazonDomain":{"type":"string","description":"Site code (currently fixed US)","example":null},"keyword":{"type":"string","description":"Original search keyword","example":"phone case"},"nicheName":{"type":"string","description":"Normalized niche name (snake_case)","example":null},"nicheRevenue360dMinUsdAtLeast":{"type":"number","description":"Last 360 days market revenue lower bound / upper bound (USD)","example":1},"nicheRevenue360dMaxUsdAtLeast":{"type":"number","description":"Last 360 days market revenue lower bound / upper bound (USD)","example":1},"nichePeakSearchVolumeAtLeast":{"type":"integer","description":"Peak monthly search volume","example":1},"nichePeakMonth":{"type":"integer","description":"Search peak month (1-12)","example":1},"nicheSearchVolumeYoyChangePctAtLeast":{"type":"number","description":"Search volume YoY change rate (%, signed)","example":1},"nicheBrandCount":{"type":"integer","description":"Active brand count and its YoY change rate","example":1},"nicheBrandCountYoyChangePctAtLeast":{"type":"number","description":"Active brand count YoY change rate","example":1},"nicheTop5ProductClickSharePctAtLeast":{"type":"number","description":"Top 5 product click share (0-100)","example":1},"featureTop5BrandSharePctAtLeast":{"type":"number","description":"Top 5 brand combined share (0-100)","example":1},"featureTopBrands":{"type":"array","description":"Top 3 brand name list (original text)","example":[]},"priceMinUsd":{"type":"number","description":"Niche overall minimum / maximum product price","example":1},"priceMaxUsd":{"type":"number","description":"Niche overall minimum / maximum product price","example":1},"priceSweetSpotMinUsd":{"type":"number","description":"Value sweet spot price range lower bound / upper bound","example":1},"priceSweetSpotMaxUsd":{"type":"number","description":"Value sweet spot price range lower bound / upper bound","example":1},"priceEntryClickSharePctAtLeast":{"type":"number","description":"Entry / Mid / High tier click share (0-100)","example":1},"priceMidClickSharePctAtLeast":{"type":"number","description":"Entry / Mid / High tier click share (0-100)","example":1},"priceHighClickSharePctAtLeast":{"type":"number","description":"Entry / Mid / High tier click share (0-100)","example":1},"demoPrimaryAgeMin":{"type":"integer","description":"Core audience age lower bound / upper bound","example":1},"demoPrimaryAgeMax":{"type":"integer","description":"Core audience age lower bound / upper bound","example":1},"demoGenderDominant":{"type":"string","description":"Dominant gender (female / male / mixed / unspecified)","example":null},"demoPrimaryIncomeTier":{"type":"string","description":"Core audience income tier","example":null},"demoLifeStageTags":{"type":"array","description":"Life stage tag list","example":[]},"featureNewAvgReviewCountAtLeast":{"type":"integer","description":"New / Established product average review count","example":1},"featureEstablishedAvgReviewCountAtLeast":{"type":"integer","description":"New / Established product average review count","example":1},"featureEmergingTrendTags":{"type":"array","description":"Emerging trend / Rare differentiation feature tags","example":[]},"featureUncommonFeatureTags":{"type":"array","description":"Emerging trend / Rare differentiation feature tags","example":[]},"searchTopCategory1Label":{"type":"string","description":"Traffic top category 1 normalized label","example":null},"reviewPositiveTop1Topic":{"type":"string","description":"Positive review #1 topic","example":null},"reviewPositiveTop1PctAtLeast":{"type":"number","description":"Positive review #1 topic and its share among positive reviews","example":1},"reviewNegativeTop1Topic":{"type":"string","description":"Negative review #1 topic","example":null},"reviewNegativeTop1PctAtLeast":{"type":"number","description":"Negative review #1 topic, share, and secondary cause","example":1},"reviewNegativeTop2Topic":{"type":"string","description":"Negative review #2 topic","example":null},"reviewStrategicInsightTags":{"type":"array","description":"Review strategic insight tags","example":[]}}}},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":[{"keyword":"phone case","nicheRevenue360dMinUsdAtLeast":1,"nicheRevenue360dMaxUsdAtLeast":1,"nichePeakSearchVolumeAtLeast":1,"nichePeakMonth":1,"nicheSearchVolumeYoyChangePctAtLeast":1,"nicheBrandCount":1,"nicheBrandCountYoyChangePctAtLeast":1,"nicheTop5ProductClickSharePctAtLeast":1,"featureTop5BrandSharePctAtLeast":1,"featureTopBrands":[],"priceMinUsd":1,"priceMaxUsd":1,"priceSweetSpotMinUsd":1,"priceSweetSpotMaxUsd":1,"priceEntryClickSharePctAtLeast":1,"priceMidClickSharePctAtLeast":1,"priceHighClickSharePctAtLeast":1,"demoPrimaryAgeMin":1,"demoPrimaryAgeMax":1,"demoLifeStageTags":[],"featureNewAvgReviewCountAtLeast":1,"featureEstablishedAvgReviewCountAtLeast":1,"featureEmergingTrendTags":[],"featureUncommonFeatureTags":[],"reviewPositiveTop1PctAtLeast":1,"reviewNegativeTop1PctAtLeast":1,"reviewStrategicInsightTags":[]}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-opportunity-search-by-metrics","x-nexscope-mcp-tool-name":"nexscope_amazon_opportunity_search_by_metrics","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-policy-feed/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Policy Feed","description":"Query Amazon is latest policy, regulation, and compliance feed. Supports paginated browsing by marketplace and time range (with AI-generated Chinese summaries), and fetching full article body by record ID. Trigger when users mention Amazon policies & regulations, seller compliance announcements, platform rule changes, policy alerts, FBA/fee policy updates, multi-marketplace policy tracking, policy original text, news details, or similar terms. Even if the user does not explicitly mention \"policy feed,\" trigger this skill whenever the request involves Amazon is officially published policies, regulations, and news for sellers, including their full text.","operationId":"runAmazonPolicyFeed","externalDocs":{"description":"Amazon Policy Feed documentation","url":"https://www.nexscope.ai/api-docs/amazon-policy-feed"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-policy-feed.","properties":{"site":{"type":"string","description":"Amazon site code, uppercase. Defaults to US.","example":"US"},"publishedAtGte":{"type":"string","description":"Publication or change time lower bound, inclusive, format yyyy-MM-dd HH:mm:ss.","example":"2026-01-01 00:00:00"},"publishedAtLte":{"type":"string","description":"Publication or change time upper bound, inclusive, format yyyy-MM-dd HH:mm:ss.","example":"2026-01-07 23:59:59"},"page":{"type":"integer","description":"Page number, starting from 1.","example":1},"pageSize":{"type":"integer","description":"Items per page, range 1-100.","example":20},"id":{"type":"string","description":"News record ID from data[].id. Required when calling the policy detail endpoint.","example":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"}},"example":{"site":"US","pageSize":20,"page":1},"additionalProperties":true},"example":{"site":"US","pageSize":20,"page":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of news items returned by the list endpoint.","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Upstream render style: tableListWorkbenches for the list or stdoutWorkbenches for detail.","example":"tableListWorkbenches"},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"News items in descending publication/change time from the list endpoint.","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"News record ID used to fetch the full body.","example":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"},"title":{"type":"string","description":"News title in the list response.","example":"Amazon policy update"},"summaryZh":{"type":"string","description":"AI-generated Chinese summary for the news item.","example":"Policy summary"},"originalUrl":{"type":"string","description":"Original article URL.","example":"https://example.com/news"},"publishedAt":{"type":"string","description":"Publication or change time, format yyyy-MM-dd HH:mm:ss.","example":"2026-01-01 00:00:00"}}}},{"type":"null"}]},"stdout":{"anyOf":[{"type":"string","description":"Full news body in Markdown format returned by the detail endpoint.","example":"# Amazon policy update"},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"News title returned by the detail endpoint.","example":"Amazon policy update"},{"type":"null"}]},"summaryZh":{"anyOf":[{"type":"string","description":"AI-generated Chinese summary returned by the detail endpoint.","example":"Policy summary"},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Total processing time in milliseconds.","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token consumption.","example":1},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Frontend column definitions returned by the list endpoint.","example":[]},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"type":"tableListWorkbenches","data":[{"id":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4","title":"Amazon policy update","summaryZh":"Policy summary","originalUrl":"https://example.com/news","publishedAt":"2026-01-01 00:00:00"}],"stdout":"# Amazon policy update","title":"Amazon policy update","summaryZh":"Policy summary","costTime":1,"costToken":1,"columns":[]},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-policy-feed","x-nexscope-mcp-tool-name":"nexscope_amazon_policy_feed","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-product-database/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Product Database","description":"Nexscope Product Database multi-condition filtering. Filter Amazon products by category, price, sales volume, revenue, reviews, rating, weight, BSR rank, LQS, seller type, and more across 10 marketplaces. Trigger when users mention Amazon product selection, product database filtering, BSR rank filtering, category-based product discovery, high-rating low-competition products, FBA product search, Amazon product discovery, or similar terms. Even if the user does not explicitly mention \"Nexscope\" or \"product database,\" trigger this skill whenever the request involves filtering Amazon products by multiple criteria or discovering potential products.","operationId":"runAmazonProductDatabase","externalDocs":{"description":"Amazon Product Database documentation","url":"https://www.nexscope.ai/api-docs/amazon-product-database"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-product-database.","properties":{"marketplace":{"type":"string","description":"Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp","example":"us"},"includeKeywords":{"type":"string","description":"Keywords to include in title/ASIN, comma-separated, up to 100 items, max 50 chars each","example":"phone case"},"excludeKeywords":{"type":"string","description":"Keywords to exclude from title/ASIN, comma-separated, up to 100 items, max 50 chars each","example":"phone case"},"categories":{"type":"string","description":"Primary category names, comma-separated, must match the standard category names for the corresponding site. US site examples: Appliances, Arts Crafts & Sewing, Automotive, Baby, Beauty & Personal Care, Books, CDs & Vinyl, Cell Phones & Accessories, Clothing Shoes & Jewelry, Collectibles & Fine Art, Computers, Digital Music, Electronics, Garden & Outdoor, Grocery & Gourmet Food, Handmade, Health Household & Baby Care, Home & Kitchen, Industrial & Scientific, Kindle Store, Kitchen & Dining, Movies & TV, Musical Instruments, Office Products, Pet Supplies, Sports & Outdoors, Tools & Home Improvement, Toys & Games, Video Games, etc. Other sites (uk, de, fr, it, es, mx, jp, ca, in) have their own localized category names"},"minPrice":{"type":"number","description":"Minimum price","example":1},"maxPrice":{"type":"number","description":"Maximum price","example":1},"minSales":{"type":"integer","description":"Minimum monthly sales","example":1},"maxSales":{"type":"integer","description":"Maximum monthly sales","example":1},"minRevenue":{"type":"number","description":"Minimum monthly revenue","example":1},"maxRevenue":{"type":"number","description":"Maximum monthly revenue","example":1},"minReviews":{"type":"integer","description":"Minimum number of reviews","example":1},"maxReviews":{"type":"integer","description":"Maximum number of reviews","example":1},"minRating":{"type":"number","description":"Minimum rating (1.0-5.0)","example":1},"maxRating":{"type":"number","description":"Maximum rating (1.0-5.0)","example":1},"minWeight":{"type":"number","description":"Minimum weight (lbs)","example":1},"maxWeight":{"type":"number","description":"Maximum weight (lbs)","example":1},"minRank":{"type":"integer","description":"Minimum BSR ranking","example":1},"maxRank":{"type":"integer","description":"Maximum BSR ranking","example":1},"minLqs":{"type":"integer","description":"Minimum LQS score (1-10)","example":1},"maxLqs":{"type":"integer","description":"Maximum LQS score (1-10)","example":1},"minSellers":{"type":"integer","description":"Minimum number of sellers","example":1},"maxSellers":{"type":"integer","description":"Maximum number of sellers","example":1},"minNet":{"type":"number","description":"Minimum net profit","example":1},"maxNet":{"type":"number","description":"Maximum net profit","example":1},"sellerTypes":{"type":"string","description":"Seller types, comma-separated. Options: amz (Amazon self-operated), fba, fbm"},"productTiers":{"type":"string","description":"Product size tiers, comma-separated. Options: oversize, standard"},"excludeTopBrands":{"type":"boolean","description":"Whether to exclude top brands","example":false},"excludeUnavailableProducts":{"type":"boolean","description":"Whether to exclude unavailable products","example":false},"minUpdatedAt":{"type":"string","description":"Data update start date (YYYY-MM-DD)","example":"2026-01-01"},"maxUpdatedAt":{"type":"string","description":"Data update end date (YYYY-MM-DD)","example":"2026-01-01"},"needCount":{"type":"integer","description":"Total number of results to return, API auto-paginates internally","example":1},"sort":{"type":"string","description":"Sort field. Options: name, -name, category, -category, revenue, -revenue, sales, -sales, price, -price, rank, -rank, reviews, -reviews, lqs, -lqs, sellers, -sellers. Prefix - indicates descending. Default: name"}},"required":["marketplace"],"example":{"sort":"-sales","marketplace":"us","includeKeywords":"phone case","needCount":10},"additionalProperties":true},"example":{"sort":"-sales","marketplace":"us","includeKeywords":"phone case","needCount":10}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"costToken":{"anyOf":[{"type":"integer","description":"Token consumption","example":1},{"type":"null"}]},"productDatabaseList":{"anyOf":[{"type":"array","description":"Product data list","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Product unique identifier","example":"example-id"},"title":{"type":"string","description":"Product title","example":null},"brand":{"type":"string","description":"Brand name","example":null},"category":{"type":"string","description":"Primary category","example":null},"breadcrumbPath":{"type":"string","description":"Full category path","example":null},"price":{"type":"number","description":"Current selling price (USD)","example":1},"approximate30DayUnitsSold":{"type":"integer","description":"Estimated units sold in last 30 days","example":1},"approximate30DayRevenue":{"type":"number","description":"Estimated revenue in last 30 days (USD)","example":1},"productRank":{"type":"integer","description":"BSR ranking","example":1},"reviews":{"type":"integer","description":"Total number of reviews","example":1},"rating":{"type":"number","description":"Average rating (1.0-5.0)","example":1},"listingQualityScore":{"type":"integer","description":"Listing quality score (LQS, 1-10)","example":1},"numberOfSellers":{"type":"integer","description":"Number of active sellers","example":1},"sellerType":{"type":"string","description":"Seller type (amz/fba/fbm)","example":null},"imageUrl":{"type":"string","description":"Product main image URL","example":"https://example.com/image.jpg"},"dateFirstAvailable":{"type":"string","description":"Date first listed","example":"2026-01-01"},"weightValue":{"type":"number","description":"Product weight","example":1},"weightUnit":{"type":"string","description":"Weight unit","example":null},"lengthValue":{"type":"number","description":"Length","example":1},"widthValue":{"type":"number","description":"Width","example":1},"heightValue":{"type":"number","description":"Height","example":1},"dimensionsUnit":{"type":"string","description":"Dimensions unit","example":null},"parentAsin":{"type":"string","description":"Parent ASIN","example":"B072MQ5BRX"},"isParent":{"type":"boolean","description":"Whether it is a parent listing","example":false},"isVariant":{"type":"boolean","description":"Whether it is a variant","example":false},"isStandalone":{"type":"boolean","description":"Whether it is a standalone product","example":false},"isAvailable":{"type":"boolean","description":"Whether it is available for purchase","example":false},"buyBoxOwner":{"type":"string","description":"Buy Box owner seller name","example":null},"buyBoxOwnerSellerId":{"type":"string","description":"Buy Box owner seller ID","example":"example-id"},"updatedAt":{"type":"string","description":"Data update time","example":"2026-01-01"},"feeBreakdown":{"type":"object","description":"Fee details: fbaFee (FBA fee), referralFee (referral fee), variableClosingFee (variable closing fee), totalFees (total fees)","example":{}},"subcategoryRanks":{"type":"array","description":"Subcategory BSR ranking list, each item contains subcategory, rank, id","example":[]},"type":{"type":"string","description":"Resource type","example":null},"variants":{"type":"array","description":"Variant list","example":[]},"upcList":{"type":"array","description":"UPC code list","example":[]},"eanList":{"type":"array","description":"EAN code list","example":[]},"isbnList":{"type":"array","description":"ISBN code list","example":[]},"gtinList":{"type":"array","description":"GTIN code list","example":[]},"dateFirstAvailableIsEstimated":{"type":"boolean","description":"Whether the listing date is estimated","example":false}}}},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"costToken":1,"productDatabaseList":[{"id":"example-id","price":1,"approximate30DayUnitsSold":1,"approximate30DayRevenue":1,"productRank":1,"reviews":1,"rating":1,"listingQualityScore":1,"numberOfSellers":1,"imageUrl":"https://example.com/image.jpg","dateFirstAvailable":"2026-01-01","weightValue":1,"lengthValue":1,"widthValue":1,"heightValue":1,"parentAsin":"B072MQ5BRX","isParent":false,"isVariant":false,"isStandalone":false,"isAvailable":false,"buyBoxOwnerSellerId":"example-id","updatedAt":"2026-01-01","feeBreakdown":{},"subcategoryRanks":[],"variants":[],"upcList":[],"eanList":[],"isbnList":[],"gtinList":[],"dateFirstAvailableIsEstimated":false}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-product-database","x-nexscope-mcp-tool-name":"nexscope_amazon_product_database","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-product-database-search/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Product Database Search","description":"Advanced Amazon product search and filtering powered by Nexscope data, supporting multi-dimensional criteria including category, price, monthly sales, keywords, BSR rank, review count, rating, package dimensions, weight, fulfillment type, and more. Trigger when users mention Nexscope product selection, Amazon product search, advanced product selection, BSR filtering, sales rank filtering, keyword-based product discovery, category search, competitor screening, niche product discovery, historical rank filtering, or similar terms. Even if the user does not explicitly mention \"Nexscope,\" trigger this skill whenever the request involves multi-criteria Amazon product search, sales-metric-based filtering, or advanced product selection beyond simple keyword search.","operationId":"runAmazonProductDatabaseSearch","externalDocs":{"description":"Amazon Product Database Search documentation","url":"https://www.nexscope.ai/api-docs/amazon-product-database-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-product-database-search.","properties":{"domain":{"type":"string","description":"Amazon domain ID: 1=United States, 2=United Kingdom, 3=Germany, 4=France, 5=Japan, 6=Canada, 8=Italy, 9=Spain, 10=India, 11=Mexico","example":"1"},"keyword":{"type":"string","description":"Title keyword (case-insensitive; spaces mean AND tokenization; wrap keywords containing spaces in double quotes; prefix - for exclusion; & symbol is replaced with space; up to 50 keywords, max 1000 characters)","example":"phone case"},"rootCategory":{"type":"array","items":{},"description":"Root category IDs (up to 50), only include products in these root categories","example":[]},"rootCategoryNames":{"type":"array","items":{},"description":"Root category names (up to 50), used when rootCategory is empty; the system automatically looks up corresponding category IDs","example":[]},"categoriesInclude":{"type":"array","items":{},"description":"Subcategory IDs to include only (up to 50), only include products directly listed in these subcategories","example":[]},"categoriesIncludeNames":{"type":"array","items":{},"description":"Subcategory names to include (up to 50), used when categoriesInclude is empty; the system automatically looks up corresponding category IDs. Supports full category paths (separated by : or >) for more accurate results","example":[]},"categoriesExclude":{"type":"array","items":{},"description":"Subcategory IDs to exclude (up to 50)","example":[]},"categoriesExcludeNames":{"type":"array","items":{},"description":"Subcategory names to exclude (up to 50), used when categoriesExclude is empty; the system automatically looks up corresponding category IDs. Supports full category paths for more accurate results","example":[]},"currentSalesGte/currentSalesLte":{"type":"integer","description":"Current sales rank range (lower value = better ranking)","example":1},"avg90SalesGte/avg90SalesLte":{"type":"integer","description":"90-day average sales rank range","example":1},"deltaPercent90SalesGte/deltaPercent90SalesLte":{"type":"integer","description":"90-day sales rank change percentage range","example":1},"monthlySoldGte/monthlySoldLte":{"type":"integer","description":"Units sold / monthly sales range","example":1},"srAvgGte/srAvgLte":{"type":"integer","description":"Historical sales rank range (positive integer, lower value = better ranking, used for the month specified by srAvgMonth)","example":1},"srAvgMonth":{"type":"string","description":"Historical sales rank - selected month (format: YYYYMM, e.g., 202511 for November 2025, within the last 36 months)"},"currentNewGte/currentNewLte":{"type":"integer","description":"Current new price range (in minor currency unit)","example":1},"currentBuyBoxShippingGte/currentBuyBoxShippingLte":{"type":"integer","description":"Current Buy Box price with shipping range (in minor currency unit)","example":1},"currentCountReviewsGte/currentCountReviewsLte":{"type":"integer","description":"Current review count range","example":1},"currentRatingGte/currentRatingLte":{"type":"number","description":"Current rating range (0.0-5.0)","example":1},"packageLengthGte/packageLengthLte":{"type":"integer","description":"Package length range (mm)","example":1},"packageWidthGte/packageWidthLte":{"type":"integer","description":"Package width range (mm)","example":1},"packageHeightGte/packageHeightLte":{"type":"integer","description":"Package height range (mm)","example":1},"packageWeightGte/packageWeightLte":{"type":"integer","description":"Package weight range (grams)","example":1},"brand":{"type":"array","items":{},"description":"Brand (OR match)","example":[]},"color":{"type":"array","items":{},"description":"Color (OR match), filter products with specified colors","example":[]},"size":{"type":"array","items":{},"description":"Size (OR match), filter products with specified sizes","example":[]},"availableDateGte/availableDateLte":{"type":"string","description":"Product listing time range (date format: yyyy-MM-dd)","example":"2026-01-01"},"buyBoxIsAmazon":{"type":"boolean","description":"Whether the Buy Box seller is Amazon","example":false},"buyBoxIsFBA":{"type":"boolean","description":"Whether the Buy Box is FBA","example":false},"isHazMat":{"type":"boolean","description":"Whether it is hazardous material","example":false},"variationCountGte/variationCountLte":{"type":"integer","description":"Variation count range","example":1},"currentCountNewGte/currentCountNewLte":{"type":"integer","description":"Current new offer count range","example":1},"outOfStockPercentage90Gte/outOfStockPercentage90Lte":{"type":"integer","description":"90-day out-of-stock percentage range","example":1},"singleVariation":{"type":"boolean","description":"Return only one variation; when set to true, multi-variation products will only return one variation","example":false},"productType":{"type":"array","items":{},"description":"Product type filter (default [0,1,2]): 0=standard product, 1=downloadable product, 2=eBook, 5=variant parent ASIN","example":[]},"history":{"type":"integer","description":"Whether to include historical data / historical sales in the response (1=include, 0=exclude, default 0)","example":1},"rating":{"type":"integer","description":"Whether to fetch rating info (1=fetch, 0=do not fetch, default 1)","example":1},"page":{"type":"integer","description":"Page number (starting from 1, default 1)","example":1},"perPage":{"type":"integer","description":"Maximum results per page (min 50, max 100, default 50)","example":50},"sort":{"type":"array","items":{},"description":"Sort (up to 3): array of objects, each containing {\"fieldName\": \"...\", \"sortDirection\": \"asc\\","example":[]}},"required":["domain"],"example":{"page":1,"perPage":50,"domain":"1","keyword":"phone case"},"additionalProperties":true},"example":{"page":1,"perPage":50,"domain":"1","keyword":"phone case"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total rows","example":1},{"type":"null"}]},"perPage":{"anyOf":[{"type":"integer","description":"Items per page","example":1},{"type":"null"}]},"currentPage":{"anyOf":[{"type":"integer","description":"Current page number","example":1},{"type":"null"}]},"totalCount":{"anyOf":[{"type":"integer","description":"Total count","example":1},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type: Nexscope","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token consumption","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list (see below)","example":[],"items":{"type":"object","properties":{"asin":{"type":"string","description":"ASIN","example":"B072MQ5BRX"},"title":{"type":"string","description":"Product title","example":null},"brand":{"type":"string","description":"Brand","example":null},"manufacturer":{"type":"string","description":"Manufacturer","example":null},"model":{"type":"string","description":"Model","example":null},"price":{"type":"number","description":"Current price (in local currency, e.g., USD/EUR)","example":1},"primePrice":{"type":"number","description":"Prime price","example":1},"currency":{"type":"string","description":"Currency","example":null},"salesRank":{"type":"integer","description":"Sales rank","example":1},"salesRank30":{"type":"integer","description":"Average sales rank in last 30 days","example":1},"salesRank90":{"type":"integer","description":"Average sales rank in last 90 days","example":1},"salesRank180":{"type":"integer","description":"Average sales rank in last 180 days","example":1},"monthlySalesUnits":{"type":"integer","description":"Monthly sales units","example":1},"monthlySalesRevenue":{"type":"number","description":"Monthly sales revenue","example":1},"monthlySalesUnits1MonthAgo":{"type":"integer","description":"Monthly sales units 1 month ago","example":1},"monthlySalesUnits2MonthsAgo":{"type":"integer","description":"Monthly sales units 2 months ago","example":1},"monthlySalesUnits3MonthsAgo":{"type":"integer","description":"Monthly sales units 3 months ago","example":1},"monthlySalesUnits4MonthsAgo":{"type":"integer","description":"Monthly sales units 4 months ago","example":1},"monthlySalesUnits5MonthsAgo":{"type":"integer","description":"Monthly sales units 5 months ago","example":1},"monthlySalesUnits6MonthsAgo":{"type":"integer","description":"Monthly sales units 6 months ago","example":1},"monthlySalesUnits7MonthsAgo":{"type":"integer","description":"Monthly sales units 7 months ago","example":1},"monthlySalesUnits8MonthsAgo":{"type":"integer","description":"Monthly sales units 8 months ago","example":1},"monthlySalesUnits9MonthsAgo":{"type":"integer","description":"Monthly sales units 9 months ago","example":1},"monthlySalesUnits10MonthsAgo":{"type":"integer","description":"Monthly sales units 10 months ago","example":1},"monthlySalesUnits11MonthsAgo":{"type":"integer","description":"Monthly sales units 11 months ago","example":1},"monthlySalesUnits12MonthsAgo":{"type":"integer","description":"Monthly sales units 12 months ago","example":1},"rating":{"type":"number","description":"Current rating (0.0-5.0)","example":1},"ratings":{"type":"integer","description":"Number of ratings","example":1},"reviewCount":{"type":"integer","description":"Number of reviews","example":1},"availableDate":{"type":"string","description":"Listing time (yyyy-MM-dd HH:mm:ss)","example":"2026-01-01 00:00:00"},"lastUpdate":{"type":"string","description":"Last update time (yyyy-MM-dd HH:mm:ss)","example":"2026-01-01 00:00:00"},"imageUrl":{"type":"string","description":"Image URL (request address)","example":"https://example.com/image.jpg"},"productImageUrls":{"type":"array","description":"Product image list","example":[]},"asinUrl":{"type":"string","description":"Amazon ASIN detail page URL","example":"https://www.amazon.com/dp/B072MQ5BRX"},"categoryTree":{"type":"string","description":"Category tree","example":null},"categoryTreeId":{"type":"string","description":"Category tree ID","example":"example-id"},"rootCategory":{"type":"integer","description":"Root category ID","example":1},"subcategories":{"type":"array","description":"Subcategory list, containing code (category ID), rank (ranking), label (category name)","example":[]},"fulfillment":{"type":"string","description":"Fulfillment method (AMZ, FBA, FBM)","example":null},"buyBoxSellerId":{"type":"string","description":"Buy Box seller ID","example":"example-id"},"sellerNum":{"type":"integer","description":"Number of sellers","example":1},"parentAsin":{"type":"string","description":"Parent ASIN","example":"B072MQ5BRX"},"variationNum":{"type":"integer","description":"Number of variations","example":1},"color":{"type":"string","description":"Color","example":null},"dimension":{"type":"string","description":"Dimensions","example":null},"dimensionsType":{"type":"string","description":"Dimensions type","example":null},"material":{"type":"string","description":"Product material, the primary material used in its construction","example":null},"weight":{"type":"string","description":"Weight (grams)","example":null},"packageWeight":{"type":"string","description":"Package weight (grams)","example":null},"packageLength":{"type":"integer","description":"Package length (mm)","example":1},"packageWidth":{"type":"integer","description":"Package width (mm)","example":1},"packageHeight":{"type":"integer","description":"Package height (mm)","example":1},"packageDimensions":{"type":"string","description":"Package dimensions","example":null},"packageQuantity":{"type":"integer","description":"Quantity of items in the package, 0 or -1 if unavailable","example":1},"itemLength":{"type":"integer","description":"Item length (mm), 0 or -1 if unavailable","example":1},"itemWidth":{"type":"integer","description":"Item width (mm), 0 or -1 if unavailable","example":1},"itemHeight":{"type":"integer","description":"Item height (mm), 0 or -1 if unavailable","example":1},"isAdultProduct":{"type":"boolean","description":"Whether it is an adult product","example":false},"isHazmat":{"type":"boolean","description":"Whether it is hazardous material","example":false},"referralFeePercentage":{"type":"number","description":"Referral fee percentage","example":1},"fbaFees":{"type":"number","description":"FBA fulfillment fee (in local currency)","example":1},"profit":{"type":"number","description":"Profit margin (percentage, e.g., 25.5 means 25.5%)","example":1},"urlSlug":{"type":"string","description":"URL slug","example":"example-product"},"sourceType":{"type":"string","description":"Source type: Nexscope","example":null},"sourceTool":{"type":"string","description":"Source tool","example":null}}}},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"perPage":1,"currentPage":1,"totalCount":1,"columns":[],"costToken":1,"products":[{"asin":"B072MQ5BRX","price":1,"primePrice":1,"salesRank":1,"salesRank30":1,"salesRank90":1,"salesRank180":1,"monthlySalesUnits":1,"monthlySalesRevenue":1,"monthlySalesUnits1MonthAgo":1,"monthlySalesUnits2MonthsAgo":1,"monthlySalesUnits3MonthsAgo":1,"monthlySalesUnits4MonthsAgo":1,"monthlySalesUnits5MonthsAgo":1,"monthlySalesUnits6MonthsAgo":1,"monthlySalesUnits7MonthsAgo":1,"monthlySalesUnits8MonthsAgo":1,"monthlySalesUnits9MonthsAgo":1,"monthlySalesUnits10MonthsAgo":1,"monthlySalesUnits11MonthsAgo":1,"monthlySalesUnits12MonthsAgo":1,"rating":1,"ratings":1,"reviewCount":1,"availableDate":"2026-01-01 00:00:00","lastUpdate":"2026-01-01 00:00:00","imageUrl":"https://example.com/image.jpg","productImageUrls":[],"asinUrl":"https://www.amazon.com/dp/B072MQ5BRX","categoryTreeId":"example-id","rootCategory":1,"subcategories":[],"buyBoxSellerId":"example-id","sellerNum":1,"parentAsin":"B072MQ5BRX","variationNum":1,"packageLength":1,"packageWidth":1,"packageHeight":1,"packageQuantity":1,"itemLength":1,"itemWidth":1,"itemHeight":1,"isAdultProduct":false,"isHazmat":false,"referralFeePercentage":1,"fbaFees":1,"profit":1,"urlSlug":"example-product"}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-product-database-search","x-nexscope-mcp-tool-name":"nexscope_amazon_product_database_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-product-detail/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Product Detail","description":"Retrieve detailed Amazon product information by ASIN, including title, Item Highlights when extractable from raw HTML, images, bullet points, specifications, A+ content, pricing, ratings & reviews, variants, and more. Trigger when users mention Amazon product details, ASIN lookup, Item Highlights, product page data, listing analysis, bullet point extraction, product image retrieval, variant inspection, competitor listing research, price lookup, review breakdown, product specification query, or similar terms. Even if the user does not explicitly say \"product details,\" trigger this skill whenever the request involves retrieving structured data from Amazon product pages via ASIN.","operationId":"runAmazonProductDetail","externalDocs":{"description":"Amazon Product Detail documentation","url":"https://www.nexscope.ai/api-docs/amazon-product-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-product-detail.","properties":{"asins":{"type":"string","description":"ASIN list, supports batch query, up to 40 ASINs. Format: ^[A-Z0-9]+(,[A-Z0-9]+){0,39}$. Example: B072MQ5BRX,B08N5WRWNW","example":"B072MQ5BRX"},"amazonDomain":{"type":"string","description":"Amazon country site, default amazon.com. Options: amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.it, amazon.es, amazon.co.jp, amazon.ca, amazon.com.au, amazon.com.br, amazon.in, amazon.nl, amazon.se, amazon.pl, amazon.sg, amazon.sa, amazon.ae, amazon.com.tr, amazon.com.mx, amazon.eg, amazon.cn, amazon.com.be"},"language":{"type":"string","description":"Language. Examples: en_US, de_DE, fr_FR, ja_JP, it_IT, es_ES, pt_BR, en_GB, zh_CN"},"deliveryZip":{"type":"string","description":"Delivery zip code, used to get delivery-related pricing. Examples: 10001 (New York, US), 10115 (Berlin, Germany), EC1A 1BB (London, UK)"},"device":{"type":"string","description":"Device type: desktop (default), mobile, tablet"},"returnBoughtTogether":{"type":"boolean","description":"Whether to return frequently bought together items (boughtTogether), default false","example":false},"returnRelatedProducts":{"type":"boolean","description":"Whether to return related product list (relatedProducts), default false","example":false},"returnAuthorsReviews":{"type":"boolean","description":"Whether to return author review list (authorsReviews), default false","example":false}},"required":["asins"],"example":{"returnRelatedProducts":false,"returnBoughtTogether":false,"asins":"B072MQ5BRX","returnAuthorsReviews":false},"additionalProperties":true},"example":{"returnRelatedProducts":false,"returnBoughtTogether":false,"asins":"B072MQ5BRX","returnAuthorsReviews":false}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total rows","example":1},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token consumption","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list (see below)","example":[],"items":{"type":"object","properties":{"asin":{"type":"string","description":"ASIN code","example":"B072MQ5BRX"},"title":{"type":"string","description":"Product title","example":null},"brand":{"type":"string","description":"Brand","example":null},"price":{"type":"number","description":"Price","example":1},"extractedPrice":{"type":"number","description":"Extracted price","example":1},"oldPrice":{"type":"number","description":"Original price","example":1},"extractedOldPrice":{"type":"number","description":"Extracted original price","example":1},"currency":{"type":"string","description":"Currency","example":null},"discount":{"type":"string","description":"Discount","example":null},"saveWithCoupon":{"type":"string","description":"Amount saved with coupon","example":null},"rating":{"type":"number","description":"Rating","example":1},"ratings":{"type":"integer","description":"Number of reviews","example":1},"prime":{"type":"boolean","description":"Whether it is a Prime item","example":false},"stock":{"type":"string","description":"Stock status","example":null},"delivery":{"type":"string","description":"Delivery information","example":null},"link":{"type":"string","description":"Product link","example":null},"linkClean":{"type":"string","description":"Clean link","example":null},"asinUrl":{"type":"string","description":"Amazon ASIN link","example":"https://www.amazon.com/dp/B072MQ5BRX"},"imageUrl":{"type":"string","description":"Thumbnail","example":"https://example.com/image.jpg"},"thumbnail":{"type":"string","description":"Thumbnail","example":null},"productImageUrls":{"type":"array","description":"Product image URL list","example":[]},"aboutItem":{"type":"array","description":"Bullet points","example":[]},"productDescription":{"type":"string","description":"Product description; when A+ content exists, this is a JSON string (see A+ structure below)","example":null},"description":{"type":"string","description":"Product description","example":null},"dimension":{"type":"string","description":"Product dimensions","example":null},"weight":{"type":"string","description":"Weight","example":null},"tags":{"type":"string","description":"Tag list","example":null},"badges":{"type":"string","description":"Badge list","example":null},"climatePledgeFriendly":{"type":"boolean","description":"Whether it is Climate Pledge Friendly","example":false},"snapEbtEligible":{"type":"boolean","description":"Whether SNAP EBT eligible","example":false},"boughtLastMonth":{"type":"string","description":"Units bought last month (string)","example":null},"boughtLastMonthCount":{"type":"integer","description":"Units bought last month (number)","example":1},"reviewsSummary":{"type":"string","description":"Review summary","example":null},"reviewsImages":{"type":"array","description":"Review image list","example":[]},"sourceTool":{"type":"string","description":"Source tool","example":null},"sourceType":{"type":"string","description":"Source type: amazon","example":null},"pageFileUrl":{"type":"string","description":"Processed product JSON file URL; not raw HTML","example":"https://example.com/product.json"},"rawHtmlFile":{"type":"string","description":"Raw Amazon product-page HTML URL from the upstream provider; optional and matched to the containing product ASIN","example":"https://example.com/product.html"},"productDetails":{"type":"object","description":"Detailed product specifications.","example":null,"properties":{"asin":{"type":"string","description":"ASIN code.","example":null},"manufacturer":{"type":"string","description":"Manufacturer.","example":null},"productDimensions":{"type":"string","description":"Product dimensions.","example":null},"upc":{"type":"string","description":"UPC code.","example":null},"units":{"type":"string","description":"Units.","example":null},"rating":{"type":"number","description":"Rating.","example":null},"review":{"type":"integer","description":"Number of reviews.","example":null}}},"customerReviews":{"type":"object","description":"Star rating distribution.","example":null,"properties":{"fiveStar":{"type":"integer","description":"Five-star review count.","example":null},"fourStar":{"type":"integer","description":"Four-star review count.","example":null},"threeStar":{"type":"integer","description":"Three-star review count.","example":null},"twoStar":{"type":"integer","description":"Two-star review count.","example":null},"oneStar":{"type":"integer","description":"One-star review count.","example":null}}},"variants":{"type":"array","description":"Product variant groups.","example":null,"items":{"type":"object","properties":{"title":{"type":"string","description":"Variant group title, such as color or size.","example":null},"items":{"type":"array","description":"Variant items.","example":null,"items":{"type":"object","properties":{"name":{"type":"string","description":"Variant name.","example":null},"asin":{"type":"string","description":"Variant ASIN.","example":null},"position":{"type":"integer","description":"Variant position.","example":null},"selected":{"type":"boolean","description":"Whether this variant is selected.","example":null}}}}}}},"itemSpecifications":{"type":"object","description":"Dynamic product specification keys and values.","example":null},"itemIngredients":{"type":"array","description":"Product ingredients.","example":null},"boughtTogether":{"type":"array","description":"Frequently bought together items when requested.","example":null,"items":{"type":"object","properties":{"asin":{"type":"string","description":"Related ASIN.","example":null},"title":{"type":"string","description":"Related product title.","example":null},"price":{"type":"string","description":"Related product price.","example":null},"extractedPrice":{"type":"number","description":"Parsed related product price.","example":null},"priceUnit":{"type":"string","description":"Related product unit price.","example":null},"extractedPriceUnit":{"type":"number","description":"Parsed related product unit price.","example":null},"thumbnail":{"type":"string","description":"Related product thumbnail.","example":null},"link":{"type":"string","description":"Related product link.","example":null},"linkClean":{"type":"string","description":"Clean related product link.","example":null},"stock":{"type":"string","description":"Related product stock status.","example":null},"delivery":{"type":"array","description":"Related product delivery information.","example":null},"position":{"type":"integer","description":"Related product position.","example":null}}}},"relatedProducts":{"type":"array","description":"Related products when requested.","example":null,"items":{"type":"object","properties":{"asin":{"type":"string","description":"Related ASIN.","example":null},"title":{"type":"string","description":"Related product title.","example":null},"price":{"type":"string","description":"Related product price.","example":null},"extractedPrice":{"type":"number","description":"Parsed related product price.","example":null},"oldPrice":{"type":"string","description":"Related product original price.","example":null},"extractedOldPrice":{"type":"number","description":"Parsed original price.","example":null},"priceUnit":{"type":"string","description":"Related product unit price.","example":null},"extractedPriceUnit":{"type":"number","description":"Parsed related product unit price.","example":null},"rating":{"type":"number","description":"Related product rating.","example":null},"reviews":{"type":"integer","description":"Related product review count.","example":null},"thumbnail":{"type":"string","description":"Related product thumbnail.","example":null},"link":{"type":"string","description":"Related product link.","example":null},"linkClean":{"type":"string","description":"Clean related product link.","example":null},"prime":{"type":"boolean","description":"Whether related product is Prime.","example":null},"sponsored":{"type":"boolean","description":"Whether related product is sponsored.","example":null},"climatePledgeFriendly":{"type":"boolean","description":"Whether related product is Climate Pledge Friendly.","example":null},"discount":{"type":"string","description":"Related product discount.","example":null},"badges":{"type":"array","description":"Related product badges.","example":null},"position":{"type":"integer","description":"Related product position.","example":null}}}},"authorsReviews":{"type":"array","description":"Author reviews when requested.","example":null,"items":{"type":"object","properties":{"title":{"type":"string","description":"Review title.","example":null},"text":{"type":"string","description":"Review content.","example":null},"author":{"type":"string","description":"Review author.","example":null},"authorImage":{"type":"string","description":"Author avatar.","example":null},"authorLink":{"type":"string","description":"Author link.","example":null},"rating":{"type":"integer","description":"Review rating.","example":null},"date":{"type":"string","description":"Review date.","example":null},"verifiedPurchase":{"type":"boolean","description":"Whether purchase is verified.","example":null},"helpfulVotes":{"type":"string","description":"Helpful vote count.","example":null},"productSize":{"type":"string","description":"Reviewed product size.","example":null},"productFlavorName":{"type":"string","description":"Reviewed product flavor.","example":null},"position":{"type":"integer","description":"Review position.","example":null}}}}}}},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"columns":[],"costToken":1,"products":[{"asin":"B072MQ5BRX","price":1,"extractedPrice":1,"oldPrice":1,"extractedOldPrice":1,"rating":1,"ratings":1,"prime":false,"asinUrl":"https://www.amazon.com/dp/B072MQ5BRX","imageUrl":"https://example.com/image.jpg","productImageUrls":[],"aboutItem":[],"climatePledgeFriendly":false,"snapEbtEligible":false,"boughtLastMonthCount":1,"reviewsImages":[],"pageFileUrl":"https://example.com/product.json","rawHtmlFile":"https://example.com/product.html"}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-product-detail","x-nexscope-mcp-tool-name":"nexscope_amazon_product_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-product-discovery/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Product Discovery","description":"Amazon product discovery and potential bestseller mining via Nexscope data. Triggered when users mention product mining, potential bestsellers, high-conversion product selection, click growth analysis, market growth opportunities, keyword-based product selection, FBA profit screening, niche market product discovery, seller origin filtering, Nexscope data, FBA profitability screening, keyword-based product selection. Even if users do not explicitly mention \"Nexscope\", this skill should be triggered whenever the task involves keyword-driven Amazon product selection based on conversion rates, click volume, and profitability metrics.","operationId":"runAmazonProductDiscovery","externalDocs":{"description":"Amazon Product Discovery documentation","url":"https://www.nexscope.ai/api-docs/amazon-product-discovery"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-product-discovery.","properties":{"keyword":{"type":"string","description":"Keyword (required; translate the keyword to the language of the selected country)","example":"phone case"},"countryCode":{"type":"string","description":"Country, use country abbreviation. Default US. Options: US, JP, DE"},"priceMin":{"type":"number","description":"Minimum product price","example":1},"priceMax":{"type":"number","description":"Maximum product price","example":1},"totalReviewsMin":{"type":"integer","description":"Minimum number of reviews","example":1},"totalReviewsMax":{"type":"integer","description":"Maximum number of reviews","example":1},"customerRatingMin":{"type":"number","description":"Minimum rating","example":1},"customerRatingMax":{"type":"number","description":"Maximum rating","example":1},"clickConversionRateMin":{"type":"number","description":"Minimum click-to-purchase conversion rate, value range 0-1, 0.1 means 10%","example":1},"clickConversionRateMax":{"type":"number","description":"Maximum click-to-purchase conversion rate, value range 0-1, 0.1 means 10%","example":1},"clickConversionRateCompositeMin":{"type":"number","description":"Minimum composite conversion rate, value range 0-1, 0.1 means 10%","example":1},"clickConversionRateCompositeMax":{"type":"number","description":"Maximum composite conversion rate, value range 0-1, 0.1 means 10%","example":1},"clickCountT7Min":{"type":"integer","description":"Minimum weekly click count","example":1},"clickCountT7Max":{"type":"integer","description":"Maximum weekly click count","example":1},"clickCountT30Min":{"type":"integer","description":"Minimum monthly click count","example":1},"clickCountT30Max":{"type":"integer","description":"Maximum monthly click count","example":1},"clickCountGrowthT7Min":{"type":"number","description":"Minimum weekly click growth rate, value range 0-1, 0.1 means 10%","example":1},"clickCountGrowthT7Max":{"type":"number","description":"Maximum weekly click growth rate, value range 0-1, 0.1 means 10%","example":1},"clickCountGrowthT30Min":{"type":"number","description":"Minimum monthly click growth rate, value range 0-1, 0.1 means 10%","example":1},"clickCountGrowthT30Max":{"type":"number","description":"Maximum monthly click growth rate, value range 0-1, 0.1 means 10%","example":1},"salesVolumeT360Min":{"type":"integer","description":"Minimum annual sales volume","example":1},"salesVolumeT360Max":{"type":"integer","description":"Maximum annual sales volume","example":1},"grossProfitMarginMin":{"type":"number","description":"Minimum gross profit margin","example":1},"grossProfitMarginMax":{"type":"number","description":"Maximum gross profit margin","example":1},"fbaFeeMin":{"type":"number","description":"Minimum FBA fee","example":1},"fbaFeeMax":{"type":"number","description":"Maximum FBA fee","example":1},"launchDateMin":{"type":"string","description":"Earliest listing time, format: yyyyMMdd000000","example":"2026-01-01"},"launchDateMax":{"type":"string","description":"Latest listing time, format: yyyyMMdd000000","example":"2026-01-01"},"nicheCountMin":{"type":"integer","description":"Minimum niche market count","example":1},"nicheCountMax":{"type":"integer","description":"Maximum niche market count","example":1},"sellerCountry":{"type":"string","description":"Seller country/region code, comma-separated for multiple selections, e.g.: CN,US"},"sortField":{"type":"string","description":"Sort field. Default purchasedClicksT360. Options: totalReviews (total reviews), price (price), launchDate (listing time), clickCountT7 (7-day click count), clickCountT30 (30-day click count), clickCountT90 (90-day click count), clickConversionRate (click-to-purchase conversion rate), clickConversionRateComposite (composite click-to-purchase conversion rate), customerRating (rating), purchasedClicksT360 (360-day purchase clicks), clickCountGrowthT7 (weekly click growth rate), clickCountGrowthT30 (monthly click growth rate), currentPrice (current price), fbaFee (FBA fee), shippingFee (FBA shipping), gpm (gross profit margin)"},"sortType":{"type":"string","description":"Sort direction. Default desc. Options: desc (descending), asc (ascending)"},"page":{"type":"integer","description":"Page number. Default 1","example":1},"pageSize":{"type":"integer","description":"Items per page (10-100). Default 50","example":10}},"required":["keyword"],"example":{"page":1,"countryCode":"US","keyword":"phone case","pageSize":10},"additionalProperties":true},"example":{"page":1,"countryCode":"US","keyword":"phone case","pageSize":10}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total count","example":1},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Tool type: Nexscope","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type: amazon","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Title","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token consumption","example":1},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":[]},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list (see below)","example":[],"items":{"type":"object","properties":{"asin":{"type":"string","description":"Amazon product ASIN","example":"B072MQ5BRX"},"parentAsin":{"type":"string","description":"Amazon product parent ASIN","example":"B072MQ5BRX"},"title":{"type":"string","description":"Product title","example":null},"brand":{"type":"string","description":"Brand","example":null},"price":{"type":"number","description":"Price","example":1},"imageUrl":{"type":"string","description":"Product main image","example":"https://example.com/image.jpg"},"productImageUrls":{"type":"array","description":"Product image URL list","example":[]},"asinUrl":{"type":"string","description":"ASIN link","example":"B072MQ5BRX"},"ratings":{"type":"integer","description":"Number of reviews","example":1},"availableDate":{"type":"string","description":"Listing time (timestamp)","example":"2026-01-01"},"availableDateString":{"type":"string","description":"Listing date (string)","example":"2026-01-01"},"categoryNames":{"type":"array","description":"Category information","example":[]},"marketplaceId":{"type":"string","description":"Site ID","example":"US"},"clickCountT7":{"type":"integer","description":"Weekly click count","example":1},"clickCountT30":{"type":"integer","description":"Monthly click count","example":1},"clickCountT90":{"type":"integer","description":"Quarterly click count","example":1},"clickConversionRate":{"type":"number","description":"Click-to-purchase conversion rate","example":1},"clickConversionRateComposite":{"type":"number","description":"Composite conversion rate","example":1},"grossProfitMargin":{"type":"number","description":"Gross profit margin","example":1},"fbaFee":{"type":"number","description":"Amazon fee","example":1},"shippingFee":{"type":"number","description":"FBA shipping fee","example":1},"sourceTool":{"type":"string","description":"Tool type: Nexscope","example":null},"sourceType":{"type":"string","description":"Source type: amazon","example":null}}}},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"costToken":1,"columns":[],"products":[{"asin":"B072MQ5BRX","parentAsin":"B072MQ5BRX","price":1,"imageUrl":"https://example.com/image.jpg","productImageUrls":[],"asinUrl":"B072MQ5BRX","ratings":1,"availableDate":"2026-01-01","availableDateString":"2026-01-01","categoryNames":[],"marketplaceId":"US","clickCountT7":1,"clickCountT30":1,"clickCountT90":1,"clickConversionRate":1,"clickConversionRateComposite":1,"grossProfitMargin":1,"fbaFee":1,"shippingFee":1}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-product-discovery","x-nexscope-mcp-tool-name":"nexscope_amazon_product_discovery","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-product-history/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Product History","description":"Retrieve Amazon product details by ASIN, including price, title, Item Highlights when available, main image, listing date, material, weight, variant monthly sales, and up to 12 months of monthly sales history. Triggered when users query Amazon product details, ASIN lookup, product pricing, sales rank history, monthly sales trends, product dimensions, FBA fees, product specifications, batch ASIN query, Nexscope product details, ASIN detail lookup, monthly sales data, pricing info, product specifications, FBA fees, batch ASIN query. Even if users do not explicitly mention \"Nexscope\", this skill should be triggered whenever the task involves obtaining structured product data for one or more Amazon ASINs.","operationId":"runAmazonProductHistory","externalDocs":{"description":"Amazon Product History documentation","url":"https://www.nexscope.ai/api-docs/amazon-product-history"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-product-history.","properties":{"asin":{"type":"string","description":"Amazon Standard Identification Number (ASIN), multiple ASINs separated by English commas, up to 5, max length 300 characters. Example: B0088PUEPK or B0088PUEPK,B00U26V4VQ,B07M68S376","example":"B072MQ5BRX"},"domain":{"type":"string","description":"Amazon domain ID. Options: 1 (United States), 2 (United Kingdom), 3 (Germany), 4 (France), 5 (Japan), 6 (Canada), 8 (Italy), 9 (Spain), 10 (India), 11 (Mexico), 12 (Brazil)","example":"1"},"history":{"type":"integer","description":"Whether to include historical data and historical sales in the response. 1 = include price history, sales rank, historical sales and other time-series data (sales for previous months), 0 = return only basic product information. Default: 0","example":1}},"required":["asin","domain"],"example":{"domain":"1","history":1,"asin":"B072MQ5BRX"},"additionalProperties":true},"example":{"domain":"1","history":1,"asin":"B072MQ5BRX"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total rows","example":1},{"type":"null"}]},"perPage":{"anyOf":[{"type":"integer","description":"Items per page","example":1},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type: Nexscope","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token consumption","example":1},{"type":"null"}]},"totalCount":{"anyOf":[{"type":"integer","description":"Total count","example":1},{"type":"null"}]},"currentPage":{"anyOf":[{"type":"integer","description":"Current page number","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list (see below)","example":[],"items":{"type":"object","properties":{"asin":{"type":"string","description":"ASIN","example":"B072MQ5BRX"},"title":{"type":"string","description":"Product title","example":null},"itemHighlights":{"type":"string","description":"Short Item Highlights separate from the title; up to 125 characters and may be null, blank, or absent","example":null},"brand":{"type":"string","description":"Brand","example":null},"manufacturer":{"type":"string","description":"Manufacturer","example":null},"model":{"type":"string","description":"Model","example":null},"color":{"type":"string","description":"Color","example":null},"material":{"type":"string","description":"Product material, the primary material used in its construction","example":null},"price":{"type":"number","description":"Current price (in local currency, e.g., USD/EUR)","example":1},"primePrice":{"type":"number","description":"Prime price","example":1},"currency":{"type":"string","description":"Currency","example":null},"rating":{"type":"number","description":"Current rating (0.0-5.0, e.g., 4.5 stars)","example":1},"ratings":{"type":"integer","description":"Number of ratings","example":1},"reviewCount":{"type":"integer","description":"Number of reviews","example":1},"salesRank":{"type":"integer","description":"Sales rank","example":1},"salesRank30":{"type":"integer","description":"Average sales rank in last 30 days","example":1},"salesRank90":{"type":"integer","description":"Average sales rank in last 90 days","example":1},"salesRank180":{"type":"integer","description":"Average sales rank in last 180 days","example":1},"monthlySalesUnits":{"type":"integer","description":"Monthly sales units","example":1},"monthlySalesRevenue":{"type":"number","description":"Monthly sales revenue","example":1},"monthlySalesUnits1MonthAgo":{"type":"integer","description":"Monthly sales 1 month ago","example":1},"monthlySalesUnits2MonthsAgo":{"type":"integer","description":"Monthly sales 2 months ago","example":1},"monthlySalesUnits3MonthsAgo":{"type":"integer","description":"Monthly sales 3 months ago","example":1},"monthlySalesUnits4MonthsAgo":{"type":"integer","description":"Monthly sales 4 months ago","example":1},"monthlySalesUnits5MonthsAgo":{"type":"integer","description":"Monthly sales 5 months ago","example":1},"monthlySalesUnits6MonthsAgo":{"type":"integer","description":"Monthly sales 6 months ago","example":1},"monthlySalesUnits7MonthsAgo":{"type":"integer","description":"Monthly sales 7 months ago","example":1},"monthlySalesUnits8MonthsAgo":{"type":"integer","description":"Monthly sales 8 months ago","example":1},"monthlySalesUnits9MonthsAgo":{"type":"integer","description":"Monthly sales 9 months ago","example":1},"monthlySalesUnits10MonthsAgo":{"type":"integer","description":"Monthly sales 10 months ago","example":1},"monthlySalesUnits11MonthsAgo":{"type":"integer","description":"Monthly sales 11 months ago","example":1},"monthlySalesUnits12MonthsAgo":{"type":"integer","description":"Monthly sales 12 months ago","example":1},"availableDate":{"type":"string","description":"Listing time (yyyy-MM-dd HH:mm:ss)","example":"2026-01-01 00:00:00"},"lastUpdate":{"type":"string","description":"Last update time (yyyy-MM-dd HH:mm:ss)","example":"2026-01-01 00:00:00"},"imageUrl":{"type":"string","description":"Image URL (request address)","example":"https://example.com/image.jpg"},"productImageUrls":{"type":"array","description":"Product image list","example":[]},"asinUrl":{"type":"string","description":"Amazon ASIN detail page URL","example":"https://www.amazon.com/dp/B072MQ5BRX"},"urlSlug":{"type":"string","description":"URL slug","example":"example-product"},"itemLength":{"type":"integer","description":"Item length in millimeters, 0 or -1 if unavailable","example":1},"itemWidth":{"type":"integer","description":"Item width in millimeters, 0 or -1 if unavailable","example":1},"itemHeight":{"type":"integer","description":"Item height in millimeters, 0 or -1 if unavailable","example":1},"dimension":{"type":"string","description":"Dimensions","example":null},"dimensionsType":{"type":"string","description":"Dimensions type","example":null},"weight":{"type":"string","description":"Weight (grams)","example":null},"packageLength":{"type":"integer","description":"Package length (mm)","example":1},"packageWidth":{"type":"integer","description":"Package width (mm)","example":1},"packageHeight":{"type":"integer","description":"Package height (mm)","example":1},"packageWeight":{"type":"string","description":"Package weight (grams)","example":null},"packageDimensions":{"type":"string","description":"Package dimensions","example":null},"packageQuantity":{"type":"integer","description":"Quantity of items in the package, 0 or -1 if unavailable","example":1},"fulfillment":{"type":"string","description":"Fulfillment method (AMZ, FBA, FBM)","example":null},"fbaFees":{"type":"number","description":"FBA fulfillment fee (in local currency)","example":1},"referralFeePercentage":{"type":"number","description":"Referral fee percentage","example":1},"profit":{"type":"number","description":"Profit margin (percentage, e.g., 25.5 means 25.5%)","example":1},"buyBoxSellerId":{"type":"string","description":"Buy Box seller ID","example":"example-id"},"sellerNum":{"type":"integer","description":"Number of sellers","example":1},"variationNum":{"type":"integer","description":"Number of variations","example":1},"parentAsin":{"type":"string","description":"Parent ASIN","example":"B072MQ5BRX"},"rootCategory":{"type":"integer","description":"Root category ID","example":1},"categoryTree":{"type":"string","description":"Category tree","example":null},"categoryTreeId":{"type":"string","description":"Category tree ID","example":"example-id"},"subcategories":{"type":"array","description":"Subcategory list, each element contains code (category ID), rank (ranking), label (category name)","example":[]},"isAdultProduct":{"type":"boolean","description":"Whether it is an adult product","example":false},"isHazmat":{"type":"boolean","description":"Whether it is hazardous material","example":false},"sourceType":{"type":"string","description":"Source type: Nexscope","example":null},"sourceTool":{"type":"string","description":"Source tool","example":null}}}},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"perPage":1,"columns":[],"costToken":1,"totalCount":1,"currentPage":1,"products":[{"asin":"B072MQ5BRX","price":1,"primePrice":1,"rating":1,"ratings":1,"reviewCount":1,"salesRank":1,"salesRank30":1,"salesRank90":1,"salesRank180":1,"monthlySalesUnits":1,"monthlySalesRevenue":1,"monthlySalesUnits1MonthAgo":1,"monthlySalesUnits2MonthsAgo":1,"monthlySalesUnits3MonthsAgo":1,"monthlySalesUnits4MonthsAgo":1,"monthlySalesUnits5MonthsAgo":1,"monthlySalesUnits6MonthsAgo":1,"monthlySalesUnits7MonthsAgo":1,"monthlySalesUnits8MonthsAgo":1,"monthlySalesUnits9MonthsAgo":1,"monthlySalesUnits10MonthsAgo":1,"monthlySalesUnits11MonthsAgo":1,"monthlySalesUnits12MonthsAgo":1,"availableDate":"2026-01-01 00:00:00","lastUpdate":"2026-01-01 00:00:00","imageUrl":"https://example.com/image.jpg","productImageUrls":[],"asinUrl":"https://www.amazon.com/dp/B072MQ5BRX","urlSlug":"example-product","itemLength":1,"itemWidth":1,"itemHeight":1,"packageLength":1,"packageWidth":1,"packageHeight":1,"packageQuantity":1,"fbaFees":1,"referralFeePercentage":1,"profit":1,"buyBoxSellerId":"example-id","sellerNum":1,"variationNum":1,"parentAsin":"B072MQ5BRX","rootCategory":1,"categoryTreeId":"example-id","subcategories":[],"isAdultProduct":false,"isHazmat":false}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-product-history","x-nexscope-mcp-tool-name":"nexscope_amazon_product_history","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-product-price-series/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Product Price Series","description":"Query Amazon product historical time-series data, including price trends, BSR (Best Sellers Rank) trends, rating changes, seller counts, and monthly sales, supporting any ASIN across multiple Amazon marketplaces. Triggered when users mention price history, price tracking, BSR history, BSR trends, historical pricing, price fluctuations, Nexscope data, rank history, price drop alerts, lightning deal historical prices, Buy Box price trends, coupon prices, FBA/FBM price comparison, seller count changes, rating trends, sales history. Even if users do not explicitly mention \"Nexscope\" or \"time-series data\", this skill should be triggered whenever the task involves analyzing Amazon product-level historical data (such as price, rank, or sales trends over time).","operationId":"runAmazonProductPriceSeries","externalDocs":{"description":"Amazon Product Price Series documentation","url":"https://www.nexscope.ai/api-docs/amazon-product-price-series"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-product-price-series.","properties":{"asin":{"type":"string","description":"Amazon Standard Identification Number (ASIN), single ASIN only, max length 1000","example":"B072MQ5BRX"},"domain":{"type":"string","description":"Amazon domain ID. Options: 1 (United States), 2 (United Kingdom), 3 (Germany), 4 (France), 5 (Japan), 6 (Canada), 8 (Italy), 9 (Spain), 10 (India), 11 (Mexico), 12 (Brazil)","example":"1"},"days":{"type":"integer","description":"Limit historical data to this many days, default 90, max 365","example":30},"showPrice":{"type":"integer","description":"Set to 1 to return the lowest new price curve in the market","example":1},"showPriceList":{"type":"integer","description":"Set to 1 to return the list/strikethrough price curve","example":1},"showPriceDeal":{"type":"integer","description":"Set to 1 to return the deal/flash sale price curve","example":1},"showPricePrime":{"type":"integer","description":"Set to 1 to return the Prime-exclusive new price curve","example":1},"showPriceFba":{"type":"integer","description":"Set to 1 to return the third-party FBA new price curve","example":1},"showPriceFbm":{"type":"integer","description":"Set to 1 to return the third-party FBM new price curve","example":1},"showPriceCoupon":{"type":"integer","description":"Set to 1 to return the coupon-applied Buy Box price curve","example":1},"showBsrMain":{"type":"integer","description":"Set to 1 to return the main category BSR curve","example":1},"showSellerCount":{"type":"integer","description":"Set to 1 to return the seller count curve","example":1}},"required":["asin","domain"],"example":{"showPricePrime":1,"showPriceList":1,"domain":"1","showPriceDeal":1,"days":30,"asin":"B072MQ5BRX","showPrice":1},"additionalProperties":true},"example":{"showPricePrime":1,"showPriceList":1,"domain":"1","showPriceDeal":1,"days":30,"asin":"B072MQ5BRX","showPrice":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"asin":{"anyOf":[{"type":"string","description":"ASIN","example":"B072MQ5BRX"},{"type":"null"}]},"buyboxPrice":{"anyOf":[{"type":"array","description":"Buy Box price (time=timestamp, value=Buy Box price)","example":[]},{"type":"null"}]},"price":{"anyOf":[{"type":"array","description":"Price (time=timestamp, value=price)","example":[]},{"type":"null"}]},"priceList":{"anyOf":[{"type":"array","description":"List/strikethrough price (time=timestamp, value=list price)","example":[]},{"type":"null"}]},"priceDeal":{"anyOf":[{"type":"array","description":"Deal price (time=timestamp, value=deal price)","example":[]},{"type":"null"}]},"pricePrime":{"anyOf":[{"type":"array","description":"Prime price (time=timestamp, value=Prime price)","example":[]},{"type":"null"}]},"priceFba":{"anyOf":[{"type":"array","description":"FBA price (time=timestamp, value=FBA price)","example":[]},{"type":"null"}]},"priceFbm":{"anyOf":[{"type":"array","description":"FBM price (time=timestamp, value=FBM price)","example":[]},{"type":"null"}]},"priceCoupon":{"anyOf":[{"type":"array","description":"Coupon price (time=timestamp, value=coupon price)","example":[]},{"type":"null"}]},"bsrMain":{"anyOf":[{"type":"array","description":"Main category BSR, each element contains categoryName (category name) and points (time=timestamp, value=ranking)","example":[]},{"type":"null"}]},"bsrSub":{"anyOf":[{"type":"array","description":"Subcategory BSR, each element contains categoryName (category name) and points (time=timestamp, value=ranking)","example":[]},{"type":"null"}]},"sellerCount":{"anyOf":[{"type":"array","description":"Seller count (time=timestamp, value=seller count)","example":[]},{"type":"null"}]},"rating":{"anyOf":[{"type":"array","description":"Rating (time=timestamp, value=rating)","example":[]},{"type":"null"}]},"ratingCount":{"anyOf":[{"type":"array","description":"Rating count (time=timestamp, value=rating count)","example":[]},{"type":"null"}]},"monthlySold":{"anyOf":[{"type":"array","description":"Child ASIN sales (time=timestamp, value=sales units)","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token consumption","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"asin":"B072MQ5BRX","buyboxPrice":[],"price":[],"priceList":[],"priceDeal":[],"pricePrime":[],"priceFba":[],"priceFbm":[],"priceCoupon":[],"bsrMain":[],"bsrSub":[],"sellerCount":[],"rating":[],"ratingCount":[],"monthlySold":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-product-price-series","x-nexscope-mcp-tool-name":"nexscope_amazon_product_price_series","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-product-research/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Product Research Directory","description":"Use this directory to find the concrete API for a research goal. It returns links and typical inputs; invoke the linked API for the actual research data.","operationId":"runAmazonProductResearch","externalDocs":{"description":"Amazon Product Research Directory documentation","url":"https://www.nexscope.ai/api-docs/amazon-product-research"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Optional category filter. Use all to list every original Amazon product-research operation.","properties":{"goal":{"type":"string","description":"Optional filter: all, search, detail, reviews, image-search, opportunity, keyword, price-history, or sales-estimates.","example":"all"}},"example":{"goal":"all"},"additionalProperties":true},"example":{"goal":"all"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"directoryType":{"type":"string","description":"Identifies this response as an API directory, not a research result.","example":"amazon-product-research-directory"},"goal":{"type":"string","description":"Applied directory filter.","example":"all"},"count":{"type":"integer","description":"Number of concrete API entries returned.","example":33},"recommendedApis":{"type":"array","description":"Concrete APIs that execute the selected research operation.","example":[],"items":{"type":"object","properties":{"operation":{"type":"string","description":"Original Skill operation name.","example":"amazon_search"},"slug":{"type":"string","description":"Concrete Skill API slug to invoke.","example":"amazon-search"},"endpoint":{"type":"string","description":"Concrete Skill API run endpoint.","example":"/api/skill-api/v1/skills/amazon-search/run"},"reason":{"type":"string","description":"What the concrete API executes.","example":"Search Amazon storefront results by keyword."},"typicalFields":{"type":"array","description":"Typical inputs for navigation; the linked API schema is authoritative.","example":["keyword","marketplace"]},"requestExample":{"type":"object","description":"Example request for the concrete API.","example":{"keyword":"wireless speaker","marketplace":"US"}}},"required":["operation","slug","endpoint","reason","typicalFields","requestExample"]}},"usage":{"type":"string","description":"Next step for callers.","example":"Invoke one recommended API directly for the actual research result."},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":["directoryType","goal","count","recommendedApis","usage"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"directoryType":"amazon-product-research-directory","goal":"all","count":33,"recommendedApis":[{"requestExample":{"keyword":"wireless speaker","marketplace":"US"},"typicalFields":["keyword","marketplace"],"operation":"amazon_search","slug":"amazon-search","endpoint":"/api/skill-api/v1/skills/amazon-search/run","reason":"Search Amazon storefront results by keyword."},{"requestExample":{"keyword":"wireless speaker","marketplace":"US"},"typicalFields":["keyword","marketplace"],"operation":"amazon_alexa_search","slug":"amazon-alexa-search","endpoint":"/api/skill-api/v1/skills/amazon-alexa-search/run","reason":"Search Amazon Alexa ranking and product results."}],"usage":"Invoke one recommended API directly for the actual research result."},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-product-research","x-nexscope-mcp-tool-name":"nexscope_amazon_product_research","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-related-asins/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Related Asins","description":"Find Amazon same-niche competitors by ASIN, with multi-dimensional filtering by click conversion rate, composite conversion rate, click volume, sales volume, reviews, ratings, price, and gross margin to identify potential competitors. Triggered when users mention same-niche competitors, ASIN competitor mining, niche competitor analysis, similar product benchmarking, ASIN benchmarking, niche market competitor list, high-conversion competitor screening, Nexscope product mining, niche competitor by ASIN, ASIN competitor analysis, same niche products, similar products discovery, conversion rate comparison, potential competitor screening, Nexscope ASIN mining. Even if users do not explicitly mention \"niche\" or \"same niche\", this skill should be triggered whenever the task involves discovering competitor lists or screening potential competitors based on a specific ASIN within the same market segment.","operationId":"runAmazonRelatedAsins","externalDocs":{"description":"Amazon Related Asins documentation","url":"https://www.nexscope.ai/api-docs/amazon-related-asins"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-related-asins.","properties":{"asin":{"type":"string","description":"Reference ASIN, used to query competitor listings that belong to the same niche as this ASIN, max length 1000 characters","example":"B072MQ5BRX"},"countryCode":{"type":"string","description":"Country code, options: US (United States), JP (Japan), DE (Germany)"},"page":{"type":"integer","description":"Page number (starting from 1)","example":1},"pageSize":{"type":"integer","description":"Items returned per page (10-100)","example":10},"sortField":{"type":"string","description":"Sort field (see sort options below)"},"sortType":{"type":"string","description":"Sort direction: desc (descending) or asc (ascending)"},"priceMin":{"type":"number","description":"Minimum product price","example":1},"priceMax":{"type":"number","description":"Maximum product price","example":1},"fbaFeeMin":{"type":"number","description":"Minimum FBA fee","example":1},"fbaFeeMax":{"type":"number","description":"Maximum FBA fee","example":1},"grossProfitMarginMin":{"type":"number","description":"Minimum gross profit margin","example":1},"grossProfitMarginMax":{"type":"number","description":"Maximum gross profit margin","example":1},"totalReviewsMin":{"type":"integer","description":"Minimum review count","example":1},"totalReviewsMax":{"type":"integer","description":"Maximum review count","example":1},"customerRatingMin":{"type":"number","description":"Minimum rating, range 0.0-5.0","example":1},"customerRatingMax":{"type":"number","description":"Maximum rating, range 0.0-5.0","example":1},"clickCountT7Min":{"type":"integer","description":"Minimum weekly click count","example":1},"clickCountT7Max":{"type":"integer","description":"Maximum weekly click count","example":1},"clickCountGrowthT7Min":{"type":"number","description":"Minimum weekly click growth rate, range 0-1, e.g., 0.1 means 10%","example":1},"clickCountGrowthT7Max":{"type":"number","description":"Maximum weekly click growth rate, range 0-1, e.g., 0.1 means 10%","example":1},"clickConversionRateMin":{"type":"number","description":"Minimum click conversion rate, range 0-1, e.g., 0.1 means 10%","example":1},"clickConversionRateMax":{"type":"number","description":"Maximum click conversion rate, range 0-1, e.g., 0.1 means 10%","example":1},"clickCountT30Min":{"type":"integer","description":"Minimum monthly click count","example":1},"clickCountT30Max":{"type":"integer","description":"Maximum monthly click count","example":1},"clickCountGrowthT30Min":{"type":"number","description":"Minimum monthly click growth rate, range 0-1, e.g., 0.1 means 10%","example":1},"clickCountGrowthT30Max":{"type":"number","description":"Maximum monthly click growth rate, range 0-1, e.g., 0.1 means 10%","example":1},"clickConversionRateCompositeMin":{"type":"number","description":"Minimum composite click conversion rate, range 0-1, e.g., 0.1 means 10%","example":1},"clickConversionRateCompositeMax":{"type":"number","description":"Maximum composite click conversion rate, range 0-1, e.g., 0.1 means 10%","example":1},"salesVolumeT360Min":{"type":"integer","description":"Minimum annual sales volume","example":1},"salesVolumeT360Max":{"type":"integer","description":"Maximum annual sales volume","example":1},"launchDateMin":{"type":"string","description":"Earliest listing time, format yyyyMMdd000000","example":"2026-01-01"},"launchDateMax":{"type":"string","description":"Latest listing time, format yyyyMMdd000000","example":"2026-01-01"},"nicheCountMin":{"type":"integer","description":"Minimum number of niche markets","example":1},"nicheCountMax":{"type":"integer","description":"Maximum number of niche markets","example":1},"sellerCountry":{"type":"string","description":"Seller country code, comma-separated for multiple countries, e.g.: CN,US"}},"required":["asin"],"example":{"asin":"B072MQ5BRX","countryCode":"US","pageSize":10,"page":1},"additionalProperties":true},"example":{"asin":"B072MQ5BRX","countryCode":"US","pageSize":10,"page":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total record count","example":1},{"type":"null"}]},"pages":{"anyOf":[{"type":"integer","description":"Total page count","example":1},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page","example":1},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size, min 10, max 100","example":10},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"ASIN product list (see product object fields below)","example":[],"items":{"type":"object","properties":{"asin":{"type":"string","description":"Amazon product ASIN","example":"B072MQ5BRX"},"parentAsin":{"type":"string","description":"Amazon product parent ASIN","example":"B072MQ5BRX"},"title":{"type":"string","description":"Product title","example":null},"brand":{"type":"string","description":"Brand","example":null},"price":{"type":"number","description":"Price","example":1},"currentPrice":{"type":"number","description":"Current price","example":1},"currency":{"type":"string","description":"Currency","example":null},"customerRating":{"type":"number","description":"Rating","example":1},"totalReviews":{"type":"integer","description":"Review count","example":1},"launchDate":{"type":"string","description":"Listing time","example":"2026-01-01"},"link":{"type":"string","description":"ASIN link","example":null},"imagesUrl":{"type":"string","description":"Product main image","example":"https://example.com/image.jpg"},"sellerName":{"type":"string","description":"Seller name","example":null},"sellerId":{"type":"string","description":"Seller ID","example":"example-id"},"fbaFee":{"type":"number","description":"FBA fee","example":1},"shippingFee":{"type":"number","description":"FBA shipping fee","example":1},"gpm":{"type":"number","description":"Gross profit margin","example":1},"clickConversionRate":{"type":"number","description":"Click conversion rate (original 7-day click conversion rate)","example":1},"clickConversionRateComposite":{"type":"number","description":"Composite click conversion rate","example":1},"clickConversionRateType":{"type":"string","description":"Conversion rate calculation type","example":null},"clickConversionRateCompositeType":{"type":"string","description":"Composite conversion rate calculation type","example":null},"clickCountT7":{"type":"integer","description":"7-day click count","example":1},"clickCountT30":{"type":"integer","description":"30-day click count","example":1},"clickCountT90":{"type":"integer","description":"90-day click count","example":1},"clickCountGrowthT7":{"type":"number","description":"Weekly click growth rate","example":1},"clickCountGrowthT30":{"type":"number","description":"Monthly click growth rate","example":1},"purchasedClicksT360":{"type":"integer","description":"360-day purchase clicks","example":1},"salesVolumeT360":{"type":"integer","description":"Annual sales volume","example":1},"nicheCount":{"type":"integer","description":"Number of niche markets the product belongs to","example":1},"sameNicheTitle":{"type":"string","description":"Same niche title","example":null},"involvedNum":{"type":"integer","description":"Number of involved keywords","example":1},"involvedFrequency":{"type":"integer","description":"Frequency of involved keywords","example":1},"categoryNames":{"type":"array","description":"Category information","example":[]},"hasMetric":{"type":"boolean","description":"Whether the product has metrics","example":false},"searchValueType":{"type":"string","description":"Search type: exact (exact match), sameNiche (same niche as reference ASIN), category (category)","example":null},"niches":{"type":"array","description":"Top 3 niche markets, containing: nicheId, nicheTitle, demand (market score), image, marketplaceId","example":[]},"bestSellersRanking":{"type":"array","description":"Best seller rankings, containing: rank (ranking), category (category name)","example":[]},"trends":{"type":"array","description":"90-day trend data, containing: day (date), clickCountT7 (weekly click count), reviewCount (review count), reviewRating (review rating), bestSellerRanking (BSR ranking), averagePriceT7 (weekly average price), totalOfferDepthT7 (7-day new offers)","example":[]},"lastUpdateTime":{"type":"string","description":"Last update time","example":"2026-01-01"}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token consumption","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"pages":1,"page":1,"pageSize":10,"data":[{"asin":"B072MQ5BRX","parentAsin":"B072MQ5BRX","price":1,"currentPrice":1,"customerRating":1,"totalReviews":1,"launchDate":"2026-01-01","imagesUrl":"https://example.com/image.jpg","sellerId":"example-id","fbaFee":1,"shippingFee":1,"gpm":1,"clickConversionRate":1,"clickConversionRateComposite":1,"clickCountT7":1,"clickCountT30":1,"clickCountT90":1,"clickCountGrowthT7":1,"clickCountGrowthT30":1,"purchasedClicksT360":1,"salesVolumeT360":1,"nicheCount":1,"involvedNum":1,"involvedFrequency":1,"categoryNames":[],"hasMetric":false,"niches":[],"bestSellersRanking":[],"trends":[],"lastUpdateTime":"2026-01-01"}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-related-asins","x-nexscope-mcp-tool-name":"nexscope_amazon_related_asins","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-reviews-list/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Reviews List","description":"Fetch and analyze Amazon product reviews by ASIN, supporting 15 marketplaces (including US) with star rating filtering. Triggered when users mention Amazon reviews, US reviews, product reviews, buyer complaints, negative reviews, positive reviews, star ratings, review analysis, review sentiment, product improvement suggestions, Vine reviews, verified purchase reviews, competitor review research, Amazon reviews, US reviews, Amazon.com reviews, product feedback, negative review analysis, positive review analysis, star rating filter, review sentiment analysis, product improvement insights, Vine reviews, competitor reviews, customer feedback. Even if users do not explicitly say \"reviews\", this skill should be triggered whenever the task involves reading, filtering, or analyzing Amazon product customer reviews.","operationId":"runAmazonReviewsList","externalDocs":{"description":"Amazon Reviews List documentation","url":"https://www.nexscope.ai/api-docs/amazon-reviews-list"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-reviews-list.","properties":{"asin":{"type":"string","description":"Amazon product ASIN","example":"B072MQ5BRX"},"domainCode":{"type":"string","description":"Amazon domain code, default com. Options: com, ca, co.uk, in, de, fr, it, es, co.jp, com.au, com.br, nl, se, com.mx, ae. Use com for the US site"},"star1Num":{"type":"integer","description":"Number of 1-star reviews, default 10, max 100","example":1},"star2Num":{"type":"integer","description":"Number of 2-star reviews, default 10, max 100","example":1},"star3Num":{"type":"integer","description":"Number of 3-star reviews, default 10, max 100","example":1},"star4Num":{"type":"integer","description":"Number of 4-star reviews, default 10, max 100","example":1},"star5Num":{"type":"integer","description":"Number of 5-star reviews, default 10, max 100","example":1},"filterByKeyword":{"type":"string","description":"Filter reviews by keyword, max length 1000 characters","example":"phone case"},"sortBy":{"type":"string","description":"Review sort order: recent (most recent reviews) or helpful (most helpful reviews), default recent"},"reviewerType":{"type":"string","description":"Reviewer type: all_reviews (all reviews) or avp_only_reviews (verified purchases only), default all_reviews"},"mediaType":{"type":"string","description":"Media type: all_contents (all content) or media_reviews_only (reviews with media only), default all_contents"},"formatType":{"type":"string","description":"Format type: all_formats (all formats) or current_format (current format), default all_formats"}},"required":["asin"],"example":{"star4Num":1,"domainCode":"com","asin":"B072MQ5BRX","star5Num":1,"star1Num":1,"star2Num":1,"star3Num":1},"additionalProperties":true},"example":{"star4Num":1,"domainCode":"com","asin":"B072MQ5BRX","star5Num":1,"star1Num":1,"star2Num":1,"star3Num":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total review count","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Review list (see review object below)","example":[],"items":{"type":"object","properties":{"reviewId":{"type":"string","description":"Review ID","example":"example-id"},"asin":{"type":"string","description":"Product ASIN","example":"B072MQ5BRX"},"title":{"type":"string","description":"Review title","example":null},"text":{"type":"string","description":"Review content","example":null},"rating":{"type":"string","description":"Rating","example":null},"date":{"type":"string","description":"Review date","example":"2026-01-01"},"userName":{"type":"string","description":"Reviewer name","example":null},"verified":{"type":"boolean","description":"Whether verified purchase","example":false},"vine":{"type":"boolean","description":"Whether Vine Voice review","example":false},"numberOfHelpful":{"type":"integer","description":"Helpful count","example":1},"imageUrlList":{"type":"array","description":"Review image list","example":[]},"videoUrlList":{"type":"array","description":"Review video list","example":[]},"domainCode":{"type":"string","description":"Country code","example":null},"productTitle":{"type":"string","description":"Product title","example":null},"productRating":{"type":"string","description":"Product rating","example":null},"countRatings":{"type":"integer","description":"Product rating count","example":1},"countReviews":{"type":"integer","description":"Product review count","example":1},"variationId":{"type":"string","description":"Variation ID","example":"example-id"},"variationList":{"type":"array","description":"Variation list","example":[]},"profilePath":{"type":"string","description":"Reviewer profile path","example":null},"currentPage":{"type":"integer","description":"Current page number","example":1},"sortStrategy":{"type":"string","description":"Sort strategy","example":null},"statusCode":{"type":"integer","description":"Status code","example":1},"statusMessage":{"type":"string","description":"Status message","example":null},"locale":{"type":"object","description":"Locale information","example":{}},"reviewSummary":{"type":"object","description":"Review summary data","example":{}},"filters":{"type":"object","description":"Applied filter conditions","example":{}}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Total token consumption","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"reviewId":"example-id","asin":"B072MQ5BRX","date":"2026-01-01","verified":false,"vine":false,"numberOfHelpful":1,"imageUrlList":[],"videoUrlList":[],"countRatings":1,"countReviews":1,"variationId":"example-id","variationList":[],"currentPage":1,"statusCode":1,"locale":{},"reviewSummary":{},"filters":{}}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-reviews-list","x-nexscope-mcp-tool-name":"nexscope_amazon_reviews_list","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-sales-estimates/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Sales Estimates","description":"Nexscope ASIN sales estimates query, returning daily estimated sales and latest known price for a specified ASIN over a given time period, covering 10 marketplaces including US, UK, Germany, and Japan. Triggered when users mention ASIN sales estimates, ASIN daily sales, sales estimation, competitor sales monitoring, average daily sales, sales trends, product sales tracking, Nexscope sales data, sales estimates, daily sales, estimated units sold, ASIN sales tracking, competitor sales monitoring, product sales trend, daily unit sales. Even if users do not explicitly mention \"Nexscope\", this skill should be triggered whenever the task involves viewing daily estimated sales data for an Amazon ASIN over a time period.","operationId":"runAmazonSalesEstimates","externalDocs":{"description":"Amazon Sales Estimates documentation","url":"https://www.nexscope.ai/api-docs/amazon-sales-estimates"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-sales-estimates.","properties":{"marketplace":{"type":"string","description":"Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp","example":"us"},"asin":{"type":"string","description":"Amazon ASIN to query","example":"B072MQ5BRX"},"startDate":{"type":"string","description":"Start date (format: YYYY-MM-DD)","example":"2026-01-01"},"endDate":{"type":"string","description":"End date (format: YYYY-MM-DD); must be earlier than the current date","example":"2026-01-01"}},"required":["marketplace","asin","startDate","endDate"],"example":{"asin":"B072MQ5BRX","marketplace":"us","endDate":"2026-01-01","startDate":"2026-01-01"},"additionalProperties":true},"example":{"asin":"B072MQ5BRX","marketplace":"us","endDate":"2026-01-01","startDate":"2026-01-01"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"costToken":{"anyOf":[{"type":"integer","description":"Token consumption","example":1},{"type":"null"}]},"salesEstimateList":{"anyOf":[{"type":"array","description":"Sales estimate result list","example":[],"items":{"type":"object","properties":{"asin":{"type":"string","description":"Queried ASIN","example":"B072MQ5BRX"},"id":{"type":"string","description":"Data point identifier","example":"example-id"},"type":{"type":"string","description":"Resource type, fixed value sales_estimate_result","example":null},"parentAsin":{"type":"string","description":"Parent ASIN (returned for variant scenarios)","example":"B072MQ5BRX"},"isParent":{"type":"boolean","description":"Whether it is a parent listing","example":false},"isVariant":{"type":"boolean","description":"Whether it is a variant listing","example":false},"isStandalone":{"type":"boolean","description":"Whether it is a standalone listing (non-variant)","example":false},"variants":{"type":"array","description":"Array of variant ASINs under this parent","example":[]},"dailyEstimates":{"type":"array","description":"Array of daily estimate data","example":[],"items":{"type":"object","properties":{"date":{"type":"string","description":"Data date (YYYY-MM-DD)","example":"2026-01-01"},"estimatedUnitsSold":{"type":"integer","description":"Estimated units sold on that day","example":1},"lastKnownPrice":{"type":"number","description":"Last known price (USD)","example":1}}}}}}},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"costToken":1,"salesEstimateList":[{"asin":"B072MQ5BRX","id":"example-id","parentAsin":"B072MQ5BRX","isParent":false,"isVariant":false,"isStandalone":false,"variants":[],"dailyEstimates":[{"date":"2026-01-01","estimatedUnitsSold":1,"lastKnownPrice":1}]}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-sales-estimates","x-nexscope-mcp-tool-name":"nexscope_amazon_sales_estimates","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-search/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Search","description":"Simulates a real user searching on Amazon's storefront to get real-time keyword ranking and search results page data. Use when the user mentions Amazon product search, search result scraping, keyword ranking on search pages, ASIN ranking position check, competitor discovery, search page price comparison, sponsored product analysis, new product monitoring, or storefront search simulation. Even if the user does not explicitly mention \"search simulation\", trigger this skill whenever their need involves real-time Amazon search results, product ranking data, or storefront SERP analysis.","operationId":"runAmazonSearch","externalDocs":{"description":"Amazon Search documentation","url":"https://www.nexscope.ai/api-docs/amazon-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"amazonDomain":{"description":"Amazon country site, default amazon.com","example":null,"type":"string"},"deliveryZip":{"description":"Delivery zip code, used to simulate Amazon frontend address. It is recommended to use commonly used zip codes for major cities in the target country, e.g., New York zip code 10001 for the US site (max length 1000)","example":null,"type":"string"},"device":{"description":"Device type: desktop, mobile, tablet, default desktop (max length 1000)","example":null,"type":"string"},"includeSellerSpriteData":{"description":"Enable additional product-data enrichment, including availableDate when available. Default: false. Enabling enrichment incurs additional dynamic charges and does not guarantee a date for every ASIN.","example":false,"type":"boolean"},"keyword":{"description":"Keyword; please translate to the language of the target country whenever possible, e.g., use English keywords for the US, German keywords for Germany, etc. (max length 1024)","example":"phone case","type":"string"},"language":{"description":"Language/region code, e.g., en_US, de_DE, ja_JP, fr_FR (max length 1000)","example":null,"type":"string"},"node":{"description":"Amazon category node (max length 1000)","example":null,"type":"string"},"page":{"description":"Page number (starting from 1, ~20 items per page), default 1","example":1,"type":"integer"},"sort":{"description":"Sort order: relevanceblender (Featured, default), price-asc-rank (Price low to high), price-desc-rank (Price high to low), review-rank (Avg. customer review), date-desc-rank (Newest arrivals), exact-aware-popularity-rank (Best sellers)","example":null,"type":"string"}},"required":[],"type":"object"},"example":{"includeSellerSpriteData":false,"keyword":"phone case","page":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"properties":{"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"data":{"anyOf":[{"additionalProperties":true,"properties":{"columns":{"anyOf":[{"description":"Rendered column definitions","example":[],"type":"array"},{"type":"null"}]},"costTime":{"anyOf":[{"description":"Execution time reported by the upstream provider.","example":null,"type":"integer"},{"type":"null"}]},"costToken":{"anyOf":[{"description":"Token consumption","example":1,"type":"integer"},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"description":"Data snapshot month returned by the upstream provider.","example":null,"type":"string"},{"type":"null"}]},"keyword":{"anyOf":[{"description":"Search keyword","example":"phone case","type":"string"},{"type":"null"}]},"page":{"anyOf":[{"description":"Current page returned by the upstream provider.","example":null,"type":"integer"},{"type":"null"}]},"pageItemCount":{"anyOf":[{"description":"Item count on the current page returned by the upstream provider.","example":null,"type":"integer"},{"type":"null"}]},"pageSize":{"anyOf":[{"description":"Page size returned by the upstream provider.","example":null,"type":"integer"},{"type":"null"}]},"products":{"anyOf":[{"description":"Search result list (see below)","example":[],"items":{"properties":{"asin":{"description":"ASIN","example":"B072MQ5BRX","type":"string"},"asinUrl":{"description":"Product link","example":"https://www.amazon.com/dp/B072MQ5BRX","type":"string"},"availableDate":{"description":"Data-source listing date, populated through includeSellerSpriteData=true when available; may still be absent. Not a verified brand launch date; timezone is unspecified. For direct ASIN lookups, use amazon-product-history or amazon-market-product-detail.","example":"2026-01-01 00:00:00","type":"string"},"badges":{"description":"Amazon frontend search badges","example":null,"type":"string"},"brand":{"description":"Brand","example":null,"type":"string"},"currency":{"description":"Currency","example":null,"type":"string"},"delivery":{"description":"Delivery information","example":null,"type":"string"},"dimension":{"description":"Dimensions","example":null,"type":"string"},"extractedOldPrice":{"description":"Parsed strikethrough price","example":1,"type":"number"},"extractedPrice":{"description":"Parsed price","example":1,"type":"number"},"extractedPriceUnit":{"description":"Parsed price unit","example":1,"type":"number"},"fulfillment":{"description":"Fulfillment information (e.g., FBA)","example":null,"type":"string"},"imageUrl":{"description":"Thumbnail","example":"https://example.com/image.jpg","type":"string"},"keyword":{"description":"Keyword","example":"phone case","type":"string"},"monthlySalesRevenue":{"description":"Monthly sales revenue","example":null,"type":"string"},"monthlySalesUnits":{"description":"Monthly sales units","example":1,"type":"integer"},"offers":{"description":"Offer information","example":null,"type":"string"},"oldPrice":{"description":"Strikethrough price","example":1,"type":"number"},"options":{"description":"Options","example":null,"type":"string"},"position":{"description":"Position","example":1,"type":"integer"},"price":{"description":"Price","example":1,"type":"number"},"priceUnit":{"description":"Price unit","example":null,"type":"string"},"rating":{"description":"Rating","example":1,"type":"number"},"ratings":{"description":"Number of ratings","example":1,"type":"integer"},"sellerNation":{"description":"Seller nationality","example":null,"type":"string"},"snapEbtEligible":{"description":"SNAP/EBT eligibility","example":false,"type":"boolean"},"sourceTool":{"description":"Source tool","example":null,"type":"string"},"sourceType":{"description":"Source type: amazon","example":null,"type":"string"},"sponsored":{"description":"Whether sponsored","example":false,"type":"boolean"},"tags":{"description":"Tags","example":null,"type":"string"},"title":{"description":"Title","example":null,"type":"string"},"weight":{"description":"Weight","example":null,"type":"string"}},"type":"object"},"type":"array"},{"type":"null"}]},"sellerSpriteEnriched":{"anyOf":[{"description":"Whether additional product-data enrichment was enabled for this request. May be absent. Not a plan or account entitlement indicator and not a guarantee that every product was enriched.","example":false,"type":"boolean"},{"type":"null"}]},"sourceTool":{"anyOf":[{"description":"Provider-specific source tool name.","example":null,"type":"string"},{"type":"null"}]},"sourceType":{"anyOf":[{"description":"Provider-specific source platform type.","example":null,"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"description":"Provider-specific response title.","example":null,"type":"string"},{"type":"null"}]},"total":{"anyOf":[{"description":"Total rows","example":1,"type":"integer"},{"type":"null"}]},"totalPage":{"anyOf":[{"description":"Total page count returned by the upstream provider.","example":null,"type":"integer"},{"type":"null"}]},"type":{"anyOf":[{"description":"Render style","example":null,"type":"string"},{"type":"null"}]}},"required":[],"type":"object"},{"type":"null"}]},"msg":{"type":["string","null"]},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"traceId":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"}},"required":["code","msg","data","ts","time","cost","traceId"],"type":"object"},"example":{"code":0,"cost":"-1","data":{"columns":[],"costToken":1,"keyword":"phone case","products":[{"asin":"B072MQ5BRX","asinUrl":"https://www.amazon.com/dp/B072MQ5BRX","availableDate":"2026-01-01 00:00:00","extractedOldPrice":1,"extractedPrice":1,"extractedPriceUnit":1,"imageUrl":"https://example.com/image.jpg","keyword":"phone case","monthlySalesUnits":1,"oldPrice":1,"position":1,"price":1,"rating":1,"ratings":1,"snapEbtEligible":false,"sponsored":false}],"sellerSpriteEnriched":false,"total":1},"msg":null,"time":"2026-01-01 00:00:00","traceId":null,"ts":"0"}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-search","x-nexscope-mcp-tool-name":"nexscope_amazon_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-search-by-image/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Search By Image","description":"Perform image-based visual product search on Amazon across 8 marketplaces. Use an image URL to find visually similar products, with optional Nexscope enrichment for sales data. Triggered when users mention Amazon image search, Amazon visual search, find similar products on Amazon, reverse image lookup Amazon, Amazon search by photo, or competitor image search. Even if the user does not explicitly mention \"image search,\" this skill should be triggered whenever a user provides an image URL and wants to find visually matching or similar products on Amazon.","operationId":"runAmazonSearchByImage","externalDocs":{"description":"Amazon Search By Image documentation","url":"https://www.nexscope.ai/api-docs/amazon-search-by-image"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-search-by-image.","properties":{"imageUrl":{"type":"string","description":"Valid, publicly accessible image URL (maximum 1,000 characters)","example":"https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg"},"amazonDomain":{"type":"string","description":"Amazon marketplace. Supported domains: United States (amazon.com), United Kingdom (amazon.co.uk), Germany (amazon.de), France (amazon.fr), Italy (amazon.it), Spain (amazon.es), Japan (amazon.co.jp), and India (amazon.in). Default: amazon.com","example":"amazon.com"},"sort":{"type":"string","description":"Sort by price, rating, or rating count. Values: default, price-asc-rank, price-desc-rank, rating-asc-rank, rating-desc-rank, ratings-asc-rank, and ratings-desc-rank"},"deliveryZip":{"type":"string","description":"Delivery postal code or city within the selected marketplace. If omitted, the marketplace default is used. Maximum 1,000 characters. Defaults: United States=10001, United Kingdom=EC1A 1BB, Germany=10115, France=75001, Italy=00100, Spain=28001, Japan=100-0001, and India=110034"},"countryOrAreaCode":{"type":"string","description":"Destination country or region code for cross-border delivery, such as CN, JP, KR, TW, HK, MO, SG, TH, VN, PH, or MY. Do not provide this together with deliveryZip. Amazon India does not support cross-border destination settings. Maximum 1,000 characters"},"aggregateByKeepaData":{"type":"boolean","description":"Whether to enrich results with Nexscope data such as sales rank, monthly sales, FBA fees, and dimensions","example":false},"responseFormat":{"type":"string","enum":["raw","matches"],"default":"raw","description":"raw preserves the provider result; matches forces enrichment and returns ranked matches."},"topN":{"type":"integer","default":20,"description":"Maximum matches in matches mode, clamped to 1-100."}},"required":["imageUrl","amazonDomain"],"example":{"aggregateByKeepaData":false,"amazonDomain":"amazon.com","imageUrl":"https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg"},"additionalProperties":true},"example":{"aggregateByKeepaData":false,"amazonDomain":"amazon.com","imageUrl":"https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total rows","example":1},{"type":"null"}]},"totalCount":{"anyOf":[{"type":"integer","description":"Total count","example":1},{"type":"null"}]},"perPage":{"anyOf":[{"type":"integer","description":"Items per page","example":1},{"type":"null"}]},"currentPage":{"anyOf":[{"type":"integer","description":"Current page","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendering style","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions used for rendering","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list; see the product fields below","example":[],"items":{"type":"object","properties":{"asin":{"type":"string","description":"ASIN","example":"B072MQ5BRX"},"title":{"type":"string","description":"Product title","example":null},"imageUrl":{"type":"string","description":"Image URL","example":"https://example.com/image.jpg"},"asinUrl":{"type":"string","description":"Amazon ASIN detail URL","example":"https://www.amazon.com/dp/B072MQ5BRX"},"price":{"type":"number","description":"Current price in the marketplace currency","example":1},"oldPrice":{"type":"number","description":"List price","example":1},"currency":{"type":"string","description":"Currency","example":null},"rating":{"type":"number","description":"Current rating from 0.0 to 5.0","example":1},"ratings":{"type":"integer","description":"Rating count","example":1},"brand":{"type":"string","description":"Brand","example":null},"sourceType":{"type":"string","description":"Product source type","example":null},"sourceTool":{"type":"string","description":"Source tool","example":null},"salesRank":{"type":"integer","description":"Sales rank from Nexscope","example":1},"salesRank30":{"type":"integer","description":"Average sales rank over the past 30 days from Nexscope","example":1},"salesRank90":{"type":"integer","description":"Average sales rank over the past 90 days from Nexscope","example":1},"salesRank180":{"type":"integer","description":"Average sales rank over the past 180 days from Nexscope","example":1},"monthlySalesUnits":{"type":"integer","description":"Monthly units sold from Nexscope","example":1},"monthlySalesRevenue":{"type":"number","description":"Monthly sales revenue from Nexscope","example":1},"monthlySalesUnits1MonthAgo":{"type":"integer","description":"Monthly units sold 1 month ago, from Nexscope","example":null},"monthlySalesUnits2MonthsAgo":{"type":"integer","description":"Monthly units sold 2 months ago, from Nexscope","example":null},"monthlySalesUnits3MonthsAgo":{"type":"integer","description":"Monthly units sold 3 months ago, from Nexscope","example":null},"monthlySalesUnits4MonthsAgo":{"type":"integer","description":"Monthly units sold 4 months ago, from Nexscope","example":null},"monthlySalesUnits5MonthsAgo":{"type":"integer","description":"Monthly units sold 5 months ago, from Nexscope","example":null},"monthlySalesUnits6MonthsAgo":{"type":"integer","description":"Monthly units sold 6 months ago, from Nexscope","example":null},"monthlySalesUnits7MonthsAgo":{"type":"integer","description":"Monthly units sold 7 months ago, from Nexscope","example":null},"monthlySalesUnits8MonthsAgo":{"type":"integer","description":"Monthly units sold 8 months ago, from Nexscope","example":null},"monthlySalesUnits9MonthsAgo":{"type":"integer","description":"Monthly units sold 9 months ago, from Nexscope","example":null},"monthlySalesUnits10MonthsAgo":{"type":"integer","description":"Monthly units sold 10 months ago, from Nexscope","example":null},"monthlySalesUnits11MonthsAgo":{"type":"integer","description":"Monthly units sold 11 months ago, from Nexscope","example":null},"monthlySalesUnits12MonthsAgo":{"type":"integer","description":"Monthly units sold 12 months ago, from Nexscope","example":null},"reviewCount":{"type":"integer","description":"Review count from Nexscope","example":1},"fbaFees":{"type":"number","description":"FBA fulfillment fee in the marketplace currency from Nexscope","example":1},"profit":{"type":"number","description":"Profit margin percentage from Nexscope; for example, 25.5 means 25.5%","example":1},"referralFeePercentage":{"type":"number","description":"Referral fee percentage from Nexscope","example":1},"fulfillment":{"type":"string","description":"Fulfillment method from Nexscope: AMZ, FBA, or FBM","example":null},"primePrice":{"type":"number","description":"Prime price from Nexscope","example":1},"buyBoxSellerId":{"type":"string","description":"Buy Box seller ID from Nexscope","example":"example-id"},"sellerNum":{"type":"integer","description":"Seller count from Nexscope","example":1},"variationNum":{"type":"integer","description":"Variation count from Nexscope","example":1},"parentAsin":{"type":"string","description":"Parent ASIN from Nexscope","example":"B072MQ5BRX"},"availableDate":{"type":"string","description":"Listing date from Nexscope in yyyy-MM-dd HH:mm:ss format","example":"2026-01-01"},"lastUpdate":{"type":"string","description":"Last update time from Nexscope in yyyy-MM-dd HH:mm:ss format","example":"2026-01-01"},"manufacturer":{"type":"string","description":"Manufacturer from Nexscope","example":null},"model":{"type":"string","description":"Model from Nexscope","example":null},"color":{"type":"string","description":"Color from Nexscope","example":null},"material":{"type":"string","description":"Primary materials used in the product construction, from Nexscope","example":null},"weight":{"type":"string","description":"Weight in grams from Nexscope","example":null},"dimension":{"type":"string","description":"Dimensions from Nexscope","example":null},"itemLength":{"type":"integer","description":"Product length in millimeters from Nexscope; 0 or -1 when unavailable","example":1},"itemWidth":{"type":"integer","description":"Product width in millimeters from Nexscope; 0 or -1 when unavailable","example":1},"itemHeight":{"type":"integer","description":"Product height in millimeters from Nexscope; 0 or -1 when unavailable","example":1},"packageLength":{"type":"integer","description":"Package length in millimeters from Nexscope","example":1},"packageWidth":{"type":"integer","description":"Package width in millimeters from Nexscope","example":1},"packageHeight":{"type":"integer","description":"Package height in millimeters from Nexscope","example":1},"packageWeight":{"type":"string","description":"Package weight in grams from Nexscope","example":null},"packageDimensions":{"type":"string","description":"Package dimensions from Nexscope","example":null},"packageQuantity":{"type":"integer","description":"Number of items in the package from Nexscope; 0 or -1 when unavailable","example":1},"dimensionsType":{"type":"string","description":"Dimension type from Nexscope","example":null},"categoryTree":{"type":"string","description":"Category tree from Nexscope","example":null},"categoryTreeId":{"type":"string","description":"Category tree ID from Nexscope","example":"example-id"},"rootCategory":{"type":"integer","description":"Root category ID from Nexscope","example":1},"isAdultProduct":{"type":"boolean","description":"Whether the product is classified as adult content by Nexscope","example":false},"isHazmat":{"type":"boolean","description":"Whether the product is classified as hazardous by Nexscope","example":false},"urlSlug":{"type":"string","description":"URL slug from Nexscope","example":null},"productImageUrls":{"type":"array","description":"Product image URLs from Nexscope","example":[]}}}},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}],"properties":{"query":{"type":"object"},"matches":{"type":"array","items":{"type":"object"}},"caveats":{"type":"array","items":{"type":"string"}}}},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"totalCount":1,"perPage":1,"currentPage":1,"columns":[],"costToken":1,"products":[{"asin":"B072MQ5BRX","imageUrl":"https://example.com/image.jpg","asinUrl":"https://www.amazon.com/dp/B072MQ5BRX","price":1,"oldPrice":1,"rating":1,"ratings":1,"salesRank":1,"salesRank30":1,"salesRank90":1,"salesRank180":1,"monthlySalesUnits":1,"monthlySalesRevenue":1,"reviewCount":1,"fbaFees":1,"profit":1,"referralFeePercentage":1,"primePrice":1,"buyBoxSellerId":"example-id","sellerNum":1,"variationNum":1,"parentAsin":"B072MQ5BRX","availableDate":"2026-01-01","lastUpdate":"2026-01-01","itemLength":1,"itemWidth":1,"itemHeight":1,"packageLength":1,"packageWidth":1,"packageHeight":1,"packageQuantity":1,"categoryTreeId":"example-id","rootCategory":1,"isAdultProduct":false,"isHazmat":false,"productImageUrls":[]}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-search-by-image","x-nexscope-mcp-tool-name":"nexscope_amazon_search_by_image","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-traffic-keywords/run":{"post":{"tags":["Keyword & Search Demand"],"summary":"Amazon Traffic Keywords","description":"Query traffic keyword lists for an Amazon ASIN via Nexscope, including traffic source type, conversion type, organic rank, and ad rank with historical month and multi-dimensional sorting. Trigger when user mentions ASIN reverse traffic keywords, traffic keyword list, keyword traffic structure, organic/ad keyword analysis, keyword conversion type, Nexscope traffic keyword, Amazon traffic keywords, reverse ASIN keywords — even if \"Nexscope\" is not explicitly mentioned, as long as the need involves viewing keyword traffic sources and keyword lists for a specific ASIN.","operationId":"runAmazonTrafficKeywords","externalDocs":{"description":"Amazon Traffic Keywords documentation","url":"https://www.nexscope.ai/api-docs/amazon-traffic-keywords"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-traffic-keywords.","properties":{"marketplace":{"type":"string","description":"Marketplace site, default US","example":"US"},"asin":{"type":"string","description":"Product ASIN to reverse lookup","example":"B072MQ5BRX"},"month":{"type":"string","description":"20)\\d{2}(0[1-9]"},"page":{"type":"integer","description":"Current page","example":1},"size":{"type":"integer","description":"Items per page","example":1},"keyword":{"type":"string","description":"Keyword filter","example":"phone case"},"badges":{"type":"string","description":"Traffic keyword type (impression position), see [Badges Enum](#badges-enum)"},"trafficKeywordTypes":{"type":"string","description":"Traffic share type, see [trafficKeywordTypes Enum](#traffickeywordtypes-enum)"},"conversionKeywordTypes":{"type":"string","description":"Traffic conversion type, see [conversionKeywordTypes Enum](#conversionkeywordtypes-enum)","example":"phone case"},"orderField":{"type":"string","description":"Sort field, see [orderField Options](#orderfield-options)"},"orderDesc":{"type":"boolean","description":"Whether to sort in descending order","example":false}},"required":["marketplace","asin"],"example":{"asin":"B072MQ5BRX","marketplace":"US","size":10,"page":1},"additionalProperties":true},"example":{"asin":"B072MQ5BRX","marketplace":"US","size":10,"page":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total count","example":1},{"type":"null"}]},"marketplace":{"anyOf":[{"type":"string","description":"Marketplace code","example":"US"},{"type":"null"}]},"asin":{"anyOf":[{"type":"string","description":"Queried ASIN","example":"B072MQ5BRX"},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Traffic keyword list (corresponds to third-party data.items)","example":[],"items":{"type":"object","properties":{"keyword":{"type":"string","description":"Keyword","example":"phone case"},"keywordCn":{"type":"string","description":"Keyword Chinese translation","example":"phone case"},"trafficKeywordType":{"type":"string","description":"Traffic share type","example":"phone case"},"conversionKeywordType":{"type":"string","description":"Traffic conversion type","example":"phone case"},"badges":{"type":"array","description":"Impression position (traffic keyword type)","example":[]},"rankPosition":{"type":"object","description":"Organic ranking position info, see [Ranking Object](#ranking-object-rankposition--adposition)","example":{},"properties":{"updatedTime":{"type":"integer","description":"Ranking time","example":1},"pageSize":{"type":"integer","description":"Items per page","example":1},"index":{"type":"integer","description":"Position on current page","example":1},"page":{"type":"integer","description":"Page number","example":1},"position":{"type":"integer","description":"Position in total results","example":1}}},"adPosition":{"type":"object","description":"Ad ranking position info, same structure as [Ranking Object](#ranking-object-rankposition--adposition)","example":{},"properties":{"updatedTime":{"type":"integer","description":"Ranking time","example":1},"pageSize":{"type":"integer","description":"Items per page","example":1},"index":{"type":"integer","description":"Position on current page","example":1},"page":{"type":"integer","description":"Page number","example":1},"position":{"type":"integer","description":"Position in total results","example":1}}},"searches":{"type":"integer","description":"Monthly search volume","example":1},"searchesRank":{"type":"integer","description":"Weekly search volume ranking","example":1},"searchesRankTimeFrom":{"type":"integer","description":"Weekly search volume ranking time range start","example":1},"searchesRankTimeTo":{"type":"integer","description":"Weekly search volume ranking time range end","example":1},"purchases":{"type":"integer","description":"Monthly purchase volume","example":1},"purchaseRate":{"type":"number","description":"Purchase rate","example":1},"products":{"type":"integer","description":"Product count","example":1},"supplyDemandRatio":{"type":"number","description":"Supply-demand ratio","example":1},"trafficPercentage":{"type":"number","description":"Traffic share","example":1},"naturalRatio":{"type":"number","description":"Traffic distribution - organic share","example":1},"adRatio":{"type":"number","description":"Traffic distribution - ad share","example":1},"calculatedWeeklySearches":{"type":"number","description":"Estimated weekly impressions","example":1},"impressions":{"type":"integer","description":"Impressions","example":1},"clicks":{"type":"integer","description":"Clicks","example":1},"bid":{"type":"number","description":"PPC bid","example":1},"bidMin":{"type":"number","description":"PPC bid lower limit","example":1},"bidMax":{"type":"number","description":"PPC bid upper limit","example":1},"latest1daysAds":{"type":"integer","description":"Ad competitors in the last 1 day","example":1},"latest7daysAds":{"type":"integer","description":"Ad competitors in the last 7 days","example":1},"latest30daysAds":{"type":"integer","description":"Ad competitors in the last 30 days","example":1},"sprt":{"type":"number","description":"SP-related ratio","example":1},"monopolyClickRate":{"type":"number","description":"Monopoly click rate","example":1},"top3ClickingRate":{"type":"number","description":"Top 3 click rate","example":1},"top3ConversionRate":{"type":"number","description":"Top 3 conversion rate","example":1},"titleDensity":{"type":"number","description":"Title density","example":1},"stats":{"type":"array","description":"High-frequency words, elements see table below","example":[],"items":{"type":"object","properties":{"keywords":{"type":"string","description":"Word","example":"phone case"},"total":{"type":"integer","description":"Total count","example":1},"rankPosition":{"type":"object","description":"Organic ranking position","example":{},"properties":{"updatedTime":{"type":"integer","description":"Ranking time","example":1},"pageSize":{"type":"integer","description":"Items per page","example":1},"index":{"type":"integer","description":"Position on current page","example":1},"page":{"type":"integer","description":"Page number","example":1},"position":{"type":"integer","description":"Position in total results","example":1}}},"adPosition":{"type":"object","description":"Ad ranking position","example":{},"properties":{"updatedTime":{"type":"integer","description":"Ranking time","example":1},"pageSize":{"type":"integer","description":"Items per page","example":1},"index":{"type":"integer","description":"Position on current page","example":1},"page":{"type":"integer","description":"Page number","example":1},"position":{"type":"integer","description":"Position in total results","example":1}}}}}},"updatedTime":{"type":"integer","description":"Update time","example":1}}}},{"type":"null"}]},"summaryList":{"anyOf":[{"type":"array","description":"High-frequency keyword summary list","example":[],"items":{"type":"object","properties":{"total":{"type":"integer","description":"Total count","example":1},"keywords":{"type":"string","description":"Keywords","example":"phone case"}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token consumption","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"marketplace":"US","asin":"B072MQ5BRX","data":[{"keyword":"phone case","keywordCn":"phone case","trafficKeywordType":"phone case","conversionKeywordType":"phone case","badges":[],"rankPosition":{"updatedTime":1,"pageSize":1,"index":1,"page":1,"position":1},"adPosition":{"updatedTime":1,"pageSize":1,"index":1,"page":1,"position":1},"searches":1,"searchesRank":1,"searchesRankTimeFrom":1,"searchesRankTimeTo":1,"purchases":1,"purchaseRate":1,"products":1,"supplyDemandRatio":1,"trafficPercentage":1,"naturalRatio":1,"adRatio":1,"calculatedWeeklySearches":1,"impressions":1,"clicks":1,"bid":1,"bidMin":1,"bidMax":1,"latest1daysAds":1,"latest7daysAds":1,"latest30daysAds":1,"sprt":1,"monopolyClickRate":1,"top3ClickingRate":1,"top3ConversionRate":1,"titleDensity":1,"stats":[{"keywords":"phone case","total":1,"rankPosition":{"updatedTime":1,"pageSize":1,"index":1,"page":1,"position":1},"adPosition":{"updatedTime":1,"pageSize":1,"index":1,"page":1,"position":1}}],"updatedTime":1}],"summaryList":[{"total":1,"keywords":"phone case"}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-traffic-keywords","x-nexscope-mcp-tool-name":"nexscope_amazon_traffic_keywords","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ebay-search/run":{"post":{"tags":["eBay Marketplace"],"summary":"Ebay Search","description":"Search and browse product listings across multiple eBay international sites. Trigger when user mentions eBay product search, eBay listing query, eBay price comparison, eBay market browsing, eBay sold items, eBay auction search, eBay product research, eBay products, eBay pricing, eBay competitors, eBay auctions, eBay market analysis — even if \"eBay\" is not explicitly mentioned, as long as the need involves searching products on eBay, comparing eBay prices, finding sold listings, or analyzing eBay market data.","operationId":"runEbaySearch","externalDocs":{"description":"Ebay Search documentation","url":"https://www.nexscope.ai/api-docs/ebay-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.ebay-search.","properties":{"keyword":{"type":"string","description":"Search keyword, max 1024 characters","example":"phone case"},"ebayDomain":{"type":"string","description":"eBay site domain, default ebay.com. Options: ebay.com (United States), ebay.co.uk (United Kingdom), ebay.de (Germany), ebay.fr (France), ebay.it (Italy), ebay.es (Spain), ebay.ca (Canada), ebay.com.au (Australia), ebay.nl (Netherlands), ebay.at (Austria), ebay.ch (Switzerland), ebay.pl (Poland), ebay.ie (Ireland), ebay.com.hk (Hong Kong, China), ebay.com.my (Malaysia), ebay.com.sg (Singapore)"},"page":{"type":"integer","description":"Page number for pagination, default 1","example":1},"pageSize":{"type":"integer","description":"Maximum results per page, default 50. Options: 25, 50, 100, 200","example":10},"orderBy":{"type":"string","description":"Sort order, default 12 (Best Match). Options: 1 (Ending soonest), 2 (Price lowest), 3 (Price highest), 7 (Distance nearest), 10 (Newly listed), 12 (Best Match), 15 (Price + shipping lowest), 16 (Price + shipping highest), 18 (New first), 19 (Used first)"},"priceMin":{"type":"number","description":"Minimum price filter","example":1},"priceMax":{"type":"number","description":"Maximum price filter","example":1},"itemCondition":{"type":"string","description":"Item condition code, multiple separated by \\"},"buyingFormat":{"type":"string","description":"Buying format. Options: Auction, BIN (Buy It Now), BO (Best Offer)"},"showOnly":{"type":"string","description":"Filter conditions, comma-separated for multiple values. Options: Complete (Ended), Sold (Sold), FR (Free returns), RPA (Returns accepted), AS (Authorized seller), Savings (Discounts), SaleItems (Sale items), Lots (Lots), Charity (Charity), AV, FS (Free shipping), LPickup (Local pickup)"},"location":{"type":"integer","description":"Country/region code of item location (e.g., 1=United States, 2=Canada, 3=United Kingdom, 45=China, 77=Germany)","example":1},"prefLoc":{"type":"string","description":"Preferred location scope. Options: 1 (Domestic), 2 (Regional), 3 (Worldwide)"},"zipCode":{"type":"string","description":"ZIP or postal code for filtering shippable items by region"},"categoryId":{"type":"integer","description":"eBay category ID for category-specific search","example":1},"noCache":{"type":"boolean","description":"Whether to bypass cache, default false","example":false}},"example":{"page":1,"keyword":"phone case","pageSize":10},"additionalProperties":true},"example":{"page":1,"keyword":"phone case","pageSize":10}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total matching results","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list array (see product fields below)","example":[],"items":{"type":"object","properties":{"productId":{"type":"string","description":"eBay product ID","example":"example-id"},"title":{"type":"string","description":"Product title","example":null},"subtitle":{"type":"string","description":"Product subtitle","example":null},"price":{"type":"number","description":"Current price / transaction price","example":1},"minPrice":{"type":"number","description":"Price range start value (for multi-SKU items)","example":1},"maxPrice":{"type":"number","description":"Price range end value (for multi-SKU items)","example":1},"oldPrice":{"type":"number","description":"Original price before discount","example":1},"currency":{"type":"string","description":"Currency unit (e.g., USD, GBP, EUR)","example":null},"condition":{"type":"string","description":"Item condition description","example":null},"link":{"type":"string","description":"eBay product detail page link","example":null},"imageUrl":{"type":"string","description":"Product thumbnail URL","example":"https://example.com/image.jpg"},"shipping":{"type":"string","description":"Shipping information","example":null},"location":{"type":"string","description":"Item location","example":null},"sellerName":{"type":"string","description":"Seller name","example":null},"sellerReviews":{"type":"integer","description":"Seller feedback count","example":1},"positiveFeedbackInPercentage":{"type":"number","description":"Seller positive feedback percentage","example":1},"salesQuantity":{"type":"integer","description":"Quantity sold","example":1},"bidsCount":{"type":"integer","description":"Bid count (for auction items)","example":1},"returns":{"type":"string","description":"Return information","example":null},"promotion":{"type":"string","description":"Promotion information","example":null},"sponsored":{"type":"boolean","description":"Whether sponsored/promoted item","example":false},"sourceType":{"type":"string","description":"Source platform identifier (ebay)","example":null},"sourceTool":{"type":"string","description":"Source tool identifier","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered column definitions","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style identifier","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token consumption","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"productId":"example-id","price":1,"minPrice":1,"maxPrice":1,"oldPrice":1,"imageUrl":"https://example.com/image.jpg","sellerReviews":1,"positiveFeedbackInPercentage":1,"salesQuantity":1,"bidsCount":1,"sponsored":false}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ebay-search","x-nexscope-mcp-tool-name":"nexscope_ebay_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/etsy-category-search/run":{"post":{"tags":["Etsy Marketplace"],"summary":"Etsy Category Search","description":"Search Etsy category data by name, ID, or parent IDs to find category identifiers for product/store filtering. Trigger when user mentions Etsy category, Etsy category ID, Etsy category tree, Etsy category lookup, syncEtsyCategory, or category search — even if the tool name is not mentioned, as long as the need is to find a category ID by keyword in a locally synced Etsy category library.","operationId":"runEtsyCategorySearch","externalDocs":{"description":"Etsy Category Search documentation","url":"https://www.nexscope.ai/api-docs/etsy-category-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.etsy-category-search.","properties":{"keyword":{"type":"string","description":"Keyword: matches category name, category id, or parentIds fields (substring)","example":"phone case"},"page":{"type":"integer","description":"Page number (starting from 1)","example":1},"pageSize":{"type":"integer","description":"Items per page, max 200","example":1}},"required":["keyword"],"example":{"page":1,"keyword":"phone case","pageSize":1},"additionalProperties":true},"example":{"page":1,"keyword":"phone case","pageSize":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records returned on this page","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token consumption (local retrieval is free)","example":1},{"type":"null"}]},"categories":{"anyOf":[{"type":"array","description":"List of matching categories","example":[],"items":{"type":"object","properties":{"categoryLevel":{"type":"integer","description":"Category level","example":1},"id":{"type":"string","description":"Category ID","example":"example-id"},"name":{"type":"string","description":"Category name","example":null},"parentId":{"type":"string","description":"Canonical primary parent category ID","example":"example-id"},"parentIds":{"type":"string","description":"All non-empty parent category IDs (comma-separated)","example":null}}}},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Title","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"costToken":1,"categories":[{"categoryLevel":1,"id":"example-id","parentId":"example-id"}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"etsy-category-search","x-nexscope-mcp-tool-name":"nexscope_etsy_category_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/etsy-product-query/run":{"post":{"tags":["Etsy Marketplace"],"summary":"Etsy Product Query","description":"Query Etsy products with multi-dimensional filters (keyword/URL, price, sales, favorites, reviews, listing date, category, handmade/vintage types, Pick/Bestseller/Raving tags). Trigger when user mentions Etsy products, Etsy listings, Etsy product sourcing, Etsy bestsellers, Etsy handmade, Etsy vintage, Etsy items, or Etsy product query — even if the tool name is not mentioned, as long as the need is to search products, view sales/price/tags, or filter items on Etsy.","operationId":"runEtsyProductQuery","externalDocs":{"description":"Etsy Product Query documentation","url":"https://www.nexscope.ai/api-docs/etsy-product-query"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.etsy-product-query.","properties":{"beginFavorites":{"type":"integer","description":"Favorite count (start), combined with end value to form the upstream favorites range","example":1},"beginFavoritesWeekly":{"type":"integer","description":"Weekly new favorites (start), combined with end value to form the upstream favorites_weekly range","example":1},"beginPrice":{"type":"number","description":"Price (start), combined with end price to form the upstream price range (e.g., 20~100). When only one side is provided, the upstream returns start~ or ~end","example":1},"beginReviews":{"type":"integer","description":"Review count (start), combined with end value to form the upstream reviews range","example":1},"beginReviewsWeekly":{"type":"integer","description":"Weekly new reviews (start), combined with end value to form the upstream reviews_weekly range","example":1},"beginSales":{"type":"integer","description":"Total sales (start), combined with end value to form the upstream sales range","example":1},"beginSalesWeekly":{"type":"integer","description":"Weekly sales (start), combined with end value to form the upstream sales_weekly range (e.g., 1~100)","example":1},"category":{"type":"string","description":"Product category ID (single category), see the Category Query API"},"country":{"type":"string","description":"Shipping country"},"currencyCode":{"type":"string","description":"Currency code"},"endFavorites":{"type":"integer","description":"Favorite count (end)","example":1},"endFavoritesWeekly":{"type":"integer","description":"Weekly new favorites (end)","example":1},"endPrice":{"type":"number","description":"Price (end), combined with start price to form the upstream price range","example":1},"endReviews":{"type":"integer","description":"Review count (end)","example":1},"endReviewsWeekly":{"type":"integer","description":"Weekly new reviews (end)","example":1},"endSales":{"type":"integer","description":"Total sales (end)","example":1},"endSalesWeekly":{"type":"integer","description":"Weekly sales (end)","example":1},"isBestsell":{"type":"integer","description":"Whether the product is a bestseller","example":1},"isPick":{"type":"integer","description":"Whether the product is a Pick item","example":1},"isRaving":{"type":"integer","description":"Whether the product is a Raving item","example":1},"listedTime":{"type":"string","description":"Listing time no earlier than this date (YYYY-MM-DD)"},"page":{"type":"integer","description":"Page number (starting from 1)","example":1},"pageSize":{"type":"integer","description":"Items per page, max 100, recommended not to exceed 50","example":10},"productType":{"type":"string","description":"Product type, comma-separated for multiple: 1=Handmade 2=Vintage 3=Digital 4=Custom 9=Other"},"searchKey":{"type":"string","description":"Search keyword or Etsy product URL"},"sortBy":{"type":"integer","description":"Sort field (corresponds to upstream sort_by, values 1~6)","example":1},"sortDesc":{"type":"integer","description":"Sort direction (corresponds to upstream desc). Schema example: descending 1, ascending 2 (encoding differs from store query's sortDesc)","example":1},"status":{"type":"integer","description":"Product status (example: 1=active, 0=inactive)","example":1}},"example":{"page":1,"pageSize":10,"searchKey":"phone case"},"additionalProperties":true},"example":{"page":1,"pageSize":10,"searchKey":"phone case"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Record count (number of records returned on this page, for alignment with list length)","example":1},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Tool type: ehunt","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type: etsy","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token consumption (estimated based on records returned on this page)","example":1},{"type":"null"}]},"productNum":{"anyOf":[{"type":"integer","description":"Total number of matching products (upstream product_num)","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Title","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Etsy product list","example":[],"items":{"type":"object","properties":{"category":{"type":"string","description":"Category name","example":null},"favorites":{"type":"integer","description":"Favorite count","example":1},"favoritesWeekly":{"type":"integer","description":"Weekly new favorites","example":1},"imageUrl":{"type":"string","description":"Main image URL","example":"https://example.com/image.jpg"},"isBestsell":{"type":"integer","description":"Whether bestseller: 1=Yes","example":1},"isPick":{"type":"integer","description":"Whether Pick: 1=Yes","example":1},"isRaving":{"type":"integer","description":"Whether Raving: 1=Yes","example":1},"price":{"type":"number","description":"Price","example":1},"productUrl":{"type":"string","description":"Product link","example":"https://example.com/image.jpg"},"releaseTime":{"type":"string","description":"Listing/release time","example":null},"reviews":{"type":"integer","description":"Review count","example":1},"reviewsWeekly":{"type":"integer","description":"Weekly new reviews","example":1},"salesTotal":{"type":"integer","description":"Total sales","example":1},"salesWeekly":{"type":"integer","description":"Weekly sales","example":1},"shipsFrom":{"type":"string","description":"Shipping country","example":null},"status":{"type":"integer","description":"Product status: 1=active, 0=inactive","example":1},"storeName":{"type":"string","description":"Store name","example":null},"tags":{"type":"string","description":"Tags","example":null},"title":{"type":"string","description":"Product title","example":null}}}},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"columns":[],"costToken":1,"productNum":1,"products":[{"favorites":1,"favoritesWeekly":1,"imageUrl":"https://example.com/image.jpg","isBestsell":1,"isPick":1,"isRaving":1,"price":1,"productUrl":"https://example.com/image.jpg","reviews":1,"reviewsWeekly":1,"salesTotal":1,"salesWeekly":1,"status":1}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"etsy-product-query","x-nexscope-mcp-tool-name":"nexscope_etsy_product_query","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/google-ai-mode-search/run":{"post":{"tags":["Search & Trend Intelligence"],"summary":"Google AI Mode Search","description":"AI Overview (AI Mode) scraping via Google Search. Returns AI-summarized key points for a single keyword, ideal for deep research, technical Q&A, long-tail product selection, and cross-border consumer preference analysis using the latest web information. Single-round only; follow-ups require the agent to summarize context and issue a new request. Triggered by: Google AI, AI Overview, AI Mode, Google AI search, AI search, deep research, consumer preference analysis, web summary, long-tail product research, cross-border market insights.","operationId":"runGoogleAiModeSearch","externalDocs":{"description":"Google AI Mode Search documentation","url":"https://www.nexscope.ai/api-docs/google-ai-mode-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.google-ai-mode-search.","properties":{"keyword":{"type":"string","description":"Google search keyword, passed as the q= parameter to initiate a Google AI Mode search. Only supports single-turn conversation; follow-up prompts are not supported. To ask follow-up questions, the agent must independently summarize key information from the previous AI overview, concatenate the new question, and send it as a new keyword in a new request","example":"best phone case material for iPhone"}},"required":["keyword"],"example":{"keyword":"best phone case material for iPhone"},"additionalProperties":true},"example":{"keyword":"best phone case material for iPhone"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"stdout":{"anyOf":[{"type":"string","description":"AI overview content in Markdown format; outputs key points and reference source links for each question's AI overview in order","example":null},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string","description":"Target URL that was crawled, the final Google search page URL","example":"https://example.com/image.jpg"},{"type":"null"}]},"resultsNum":{"anyOf":[{"type":"integer","description":"Number of AI overview blocks; >0 indicates the page rendered an AI Overview, 0 indicates the keyword did not trigger an AI Overview","example":1},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"API latency in milliseconds","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token consumption for this call; billed only when upstream returns success","example":1},{"type":"null"}]},"taskId":{"anyOf":[{"type":"string","description":"Upstream capture task identifier for this request","example":"example-id"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style, fixed stdoutWorkbenches, used with the stdout field for Markdown rendering","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"sourceUrl":"https://example.com/image.jpg","resultsNum":1,"costTime":1,"costToken":1,"taskId":"example-id"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"google-ai-mode-search","x-nexscope-mcp-tool-name":"nexscope_google_ai_mode_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/google-trends-by-keywords/run":{"post":{"tags":["Keyword & Search Demand"],"summary":"Google Trends By Keywords","description":"Google Trends keyword search popularity comparison and trend analysis, supporting global regions and custom time ranges. Triggered by: Google Trends, keyword popularity over time, search interest comparison, keyword trend analysis, seasonal trend detection, regional search popularity, keyword heatmap, multi-keyword comparison on Google, keyword research, market trend analysis, search trends, seasonal analysis, regional popularity.","operationId":"runGoogleTrendsByKeywords","externalDocs":{"description":"Google Trends By Keywords documentation","url":"https://www.nexscope.ai/api-docs/google-trends-by-keywords"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.google-trends-by-keywords.","properties":{"keyword":{"type":"string","description":"Keyword (the keyword must be in the language of the target country! For example, use English keywords for the US, German keywords for Germany. If not in the corresponding country's language, please translate first.) Max length 100 characters","example":"phone case"},"region":{"type":"string","description":"Country/region, default US. Options: US, GB, JP, CA, MX, DE, FR, IT, ES, NL, AU, SG, AE, BR, IN, TR, PL, SE","example":"US"},"dayRangeStart":{"type":"string","description":"Time range start (use when you want to freely specify the time range; custom time range takes priority), format YYYY-MM-DD, starting from 2004"},"dayRangeEnd":{"type":"string","description":"Time range end (use when you want to freely specify the time range; custom time range takes priority), format YYYY-MM-DD, starting from 2004"}},"required":["keyword"],"example":{"keyword":"phone case","region":"US"},"additionalProperties":true},"example":{"keyword":"phone case","region":"US"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"trendInfoForKeys":{"anyOf":[{"type":"array","description":"Keyword trend info array","example":[],"items":{"type":"object","properties":{"keyword":{"type":"string","description":"Keyword","example":"phone case"},"trendValues":{"type":"array","description":"Trend value array","example":[],"items":{"type":"object","properties":{"timeRange":{"type":"string","description":"Time, format yyyy-MM-dd","example":null},"value":{"type":"string","description":"Value (normalized search interest, 0-100)","example":null}}}}}}},{"type":"null"}]},"chartOption":{"anyOf":[{"type":"object","description":"Chart rendering metadata","example":{},"properties":{"type":{"anyOf":[{"type":"string","description":"Data type","example":null},{"type":"null"}]},"fieldX":{"anyOf":[{"type":"string","description":"X-axis field","example":null},{"type":"null"}]},"fieldY":{"anyOf":[{"type":"array","description":"Y-axis fields","example":[]},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Data","example":[]},{"type":"null"}]}}},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token consumption","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"trendInfoForKeys":[{"keyword":"phone case","trendValues":[]}],"chartOption":{"fieldY":[],"data":[]},"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"google-trends-by-keywords","x-nexscope-mcp-tool-name":"nexscope_google_trends_by_keywords","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/google-trends-by-time/run":{"post":{"tags":["Search & Trend Intelligence"],"summary":"Google Trends By Time","description":"Query and analyze Google Trends real-time hot topics and trending searches for a specified time range and country/region. Triggered by: Google Trends, hot topics, real-time trending, popular trends, current hot searches, recent trending, viral topics, trending searches, trend discovery, market trends, what's popular, trending now, breakout topics.","operationId":"runGoogleTrendsByTime","externalDocs":{"description":"Google Trends By Time documentation","url":"https://www.nexscope.ai/api-docs/google-trends-by-time"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.google-trends-by-time.","properties":{"days":{"type":"integer","description":"Time range, query trend data for the last N days, default 7. Common values: 1, 2, 7","example":1},"region":{"type":"string","description":"Country/region code, default US. Options: US, GB, JP, CA, MX, DE, FR, IT, ES, NL, AU, SG, AE, BR, IN, TR, PL, SE","example":"US"}},"example":{"days":1,"region":"US"},"additionalProperties":true},"example":{"days":1,"region":"US"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"costToken":{"anyOf":[{"type":"integer","description":"Token consumption","example":1},{"type":"null"}]},"chartOption":{"anyOf":[{"type":"object","description":"Chart config object, containing visualization data","example":{},"properties":{"data":{"anyOf":[{"type":"array","description":"Data, array of chart data point objects","example":[]},{"type":"null"}]},"fieldX":{"anyOf":[{"type":"string","description":"X-axis field","example":null},{"type":"null"}]},"fieldY":{"anyOf":[{"type":"array","description":"Y-axis fields","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Data type","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Title","example":null},{"type":"null"}]}}},{"type":"null"}]},"trendValues":{"anyOf":[{"type":"array","description":"Trend values, array of trending query objects (see below)","example":[],"items":{"type":"object","properties":{"query":{"type":"string","description":"Keyword","example":"phone case"},"searchVolume":{"type":"integer","description":"Search volume value","example":1},"increasePercentage":{"type":"integer","description":"Percentage increase: integer, range -100 to 100, unit is %","example":1},"startTime":{"type":"string","description":"Start timestamp","example":null},"endTime":{"type":"string","description":"End timestamp","example":null}}}},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"costToken":1,"chartOption":{"data":[],"fieldY":[]},"trendValues":[{"query":"phone case","searchVolume":1,"increasePercentage":1}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"google-trends-by-time","x-nexscope-mcp-tool-name":"nexscope_google_trends_by_time","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/banana-image-generation/run":{"post":{"tags":["Image Generation Models"],"summary":"Nano Banana Image Generation","description":"Generate ecommerce images with the Nano Banana base image model. The model is fixed by this API, so provider must not be supplied in the request.","operationId":"runBananaImageGeneration","externalDocs":{"description":"Nano Banana Image Generation documentation","url":"https://www.nexscope.ai/api-docs/banana-image-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate ecommerce images with the Nano Banana base image model.","properties":{"imageUrls":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs required by this image generation API. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.","example":["https://example.com/product.jpg"],"minItems":1,"maxItems":10},"prompt":{"type":"string","description":"Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.","example":"Keep the product consistent and generate a clean white-background ecommerce hero image.","maxLength":5000},"outputNum":{"type":"integer","description":"Number of images to generate. Valid range: 1 to 10; defaults to 1.","example":1,"minimum":1,"maximum":10},"resolution":{"type":"string","description":"Output resolution. Supported values: 1K only.","example":"1K"},"aspectRatio":{"type":"string","description":"Output aspect ratio. Supported values: 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 4:5, 5:4, 21:9.","example":"1:1"}},"required":["imageUrls","prompt"],"example":{"imageUrls":["https://example.com/product.jpg"],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"1K","aspectRatio":"1:1"},"additionalProperties":true},"example":{"imageUrls":["https://example.com/product.jpg"],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"1K","aspectRatio":"1:1"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"banana-image-generation","x-nexscope-mcp-tool-name":"nexscope_banana_image_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/banana-pro-image-generation/run":{"post":{"tags":["Image Generation Models"],"summary":"Nano Banana Pro Image Generation","description":"Generate higher-resolution ecommerce images with the Nano Banana Pro model. The model is fixed by this API, so provider must not be supplied in the request.","operationId":"runBananaProImageGeneration","externalDocs":{"description":"Nano Banana Pro Image Generation documentation","url":"https://www.nexscope.ai/api-docs/banana-pro-image-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate higher-resolution ecommerce images with the Nano Banana Pro model.","properties":{"imageUrls":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs required by this image generation API. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.","example":["https://example.com/product.jpg"],"minItems":1,"maxItems":10},"prompt":{"type":"string","description":"Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.","example":"Keep the product consistent and generate a clean white-background ecommerce hero image.","maxLength":5000},"outputNum":{"type":"integer","description":"Number of images to generate. Valid range: 1 to 10; defaults to 1.","example":1,"minimum":1,"maximum":10},"resolution":{"type":"string","description":"Output resolution. Supported values: 1K, 2K, or 4K; defaults to 1K.","example":"1K"},"aspectRatio":{"type":"string","description":"Output aspect ratio. Supported values: 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 4:5, 5:4, 21:9.","example":"1:1"}},"required":["imageUrls","prompt"],"example":{"imageUrls":["https://example.com/product.jpg"],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"1K","aspectRatio":"1:1"},"additionalProperties":true},"example":{"imageUrls":["https://example.com/product.jpg"],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"1K","aspectRatio":"1:1"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"banana-pro-image-generation","x-nexscope-mcp-tool-name":"nexscope_banana_pro_image_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/banana-2-1-image-generation/run":{"post":{"tags":["Image Generation Models"],"summary":"Nano Banana 2.1 Image Generation","description":"Generate and edit ecommerce images with Nano Banana 2.1, with improved text layout and consistency across editing rounds. The model is fixed by this API, so provider must not be supplied in the request.","operationId":"runBanana21ImageGeneration","externalDocs":{"description":"Nano Banana 2.1 Image Generation documentation","url":"https://www.nexscope.ai/api-docs/banana-2-1-image-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate and edit ecommerce images with Nano Banana 2.1, with improved text layout and consistency across editing rounds.","properties":{"imageUrls":{"type":"array","description":"Optional public reference image URLs. Omit this field for text-to-image generation, or provide references for image-to-image generation. When supplied, provide 1 to 14 JPG, PNG, or WEBP images; each image must not exceed 20 MB.","example":[],"items":{"type":"string"},"minItems":0,"maxItems":14},"prompt":{"type":"string","description":"Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.","example":"Keep the product consistent and generate a clean white-background ecommerce hero image.","maxLength":5000},"outputNum":{"type":"integer","description":"Number of images to generate. Valid range: 1 to 10; defaults to 1.","example":1,"minimum":1,"maximum":10},"resolution":{"type":"string","description":"Output resolution. Supported values: 1K, 2K, or 4K; defaults to 1K.","example":"1K","enum":["1K","2K","4K"]},"aspectRatio":{"type":"string","description":"Output aspect ratio. Supported values: 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 4:5, 5:4, 21:9.","example":"1:1","enum":["1:1","16:9","9:16","3:4","4:3","3:2","2:3","4:5","5:4","21:9"]}},"required":["prompt"],"example":{"imageUrls":[],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"1K","aspectRatio":"1:1"},"additionalProperties":true},"example":{"imageUrls":[],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"1K","aspectRatio":"1:1"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"banana-2-1-image-generation","x-nexscope-mcp-tool-name":"nexscope_banana_2_1_image_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/banana-2-image-generation/run":{"post":{"tags":["Image Generation Models"],"summary":"Nano Banana 2 Image Generation","description":"Generate ecommerce images with the Nano Banana 2 model. The model is fixed by this API, so provider must not be supplied in the request.","operationId":"runBanana2ImageGeneration","externalDocs":{"description":"Nano Banana 2 Image Generation documentation","url":"https://www.nexscope.ai/api-docs/banana-2-image-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate ecommerce images with the Nano Banana 2 model.","properties":{"imageUrls":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs required by this image generation API. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.","example":["https://example.com/product.jpg"],"minItems":1,"maxItems":10},"prompt":{"type":"string","description":"Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.","example":"Keep the product consistent and generate a clean white-background ecommerce hero image.","maxLength":5000},"outputNum":{"type":"integer","description":"Number of images to generate. Valid range: 1 to 10; defaults to 1.","example":1,"minimum":1,"maximum":10},"resolution":{"type":"string","description":"Output resolution. Supported values: 1K, 2K, or 4K; defaults to 1K.","example":"1K"},"aspectRatio":{"type":"string","description":"Output aspect ratio. Supported values: 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 16:9, 9:16, 21:9.","example":"1:1"}},"required":["imageUrls","prompt"],"example":{"imageUrls":["https://example.com/product.jpg"],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"1K","aspectRatio":"1:1"},"additionalProperties":true},"example":{"imageUrls":["https://example.com/product.jpg"],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"1K","aspectRatio":"1:1"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"banana-2-image-generation","x-nexscope-mcp-tool-name":"nexscope_banana_2_image_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/banana-2-lite-image-generation/run":{"post":{"tags":["Image Generation Models"],"summary":"Nano Banana 2 Lite Image Generation","description":"Generate ecommerce images with the Nano Banana 2 Lite model. The model is fixed by this API, so provider must not be supplied in the request.","operationId":"runBanana2LiteImageGeneration","externalDocs":{"description":"Nano Banana 2 Lite Image Generation documentation","url":"https://www.nexscope.ai/api-docs/banana-2-lite-image-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate ecommerce images with the Nano Banana 2 Lite model.","properties":{"imageUrls":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs required by this image generation API. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.","example":["https://example.com/product.jpg"],"minItems":1,"maxItems":10},"prompt":{"type":"string","description":"Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.","example":"Keep the product consistent and generate a clean white-background ecommerce hero image.","maxLength":5000},"outputNum":{"type":"integer","description":"Number of images to generate. Valid range: 1 to 10; defaults to 1.","example":1,"minimum":1,"maximum":10},"resolution":{"type":"string","description":"Output resolution. Supported values: 1K only.","example":"1K"},"aspectRatio":{"type":"string","description":"Output aspect ratio. Supported values: 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9.","example":"1:1"}},"required":["imageUrls","prompt"],"example":{"imageUrls":["https://example.com/product.jpg"],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"1K","aspectRatio":"1:1"},"additionalProperties":true},"example":{"imageUrls":["https://example.com/product.jpg"],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"1K","aspectRatio":"1:1"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"banana-2-lite-image-generation","x-nexscope-mcp-tool-name":"nexscope_banana_2_lite_image_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/wan-2-7-image-generation/run":{"post":{"tags":["Image Generation Models"],"summary":"Wan 2.7 Image Generation","description":"Generate ecommerce images with the Wan 2.7 image model. The model is fixed by this API, so provider must not be supplied in the request.","operationId":"runWan27ImageGeneration","externalDocs":{"description":"Wan 2.7 Image Generation documentation","url":"https://www.nexscope.ai/api-docs/wan-2-7-image-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate ecommerce images with the Wan 2.7 image model.","properties":{"imageUrls":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs required by this image generation API. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.","example":["https://example.com/product.jpg"],"minItems":1,"maxItems":10},"prompt":{"type":"string","description":"Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.","example":"Keep the product consistent and generate a clean white-background ecommerce hero image.","maxLength":5000},"outputNum":{"type":"integer","description":"Number of images to generate. Valid range: 1 to 10; defaults to 1.","example":1,"minimum":1,"maximum":10},"resolution":{"type":"string","description":"Output resolution. Supported values: 1K or 2K; defaults to 1K.","example":"1K"},"aspectRatio":{"type":"string","description":"Output aspect ratio. Supported values: 1:1, 1:4, 4:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 16:9, 9:16, 21:9.","example":"1:1"}},"required":["imageUrls","prompt"],"example":{"imageUrls":["https://example.com/product.jpg"],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"1K","aspectRatio":"1:1"},"additionalProperties":true},"example":{"imageUrls":["https://example.com/product.jpg"],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"1K","aspectRatio":"1:1"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"wan-2-7-image-generation","x-nexscope-mcp-tool-name":"nexscope_wan_2_7_image_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seedream-5-pro-image-generation/run":{"post":{"tags":["Image Generation Models"],"summary":"Seedream 5 Pro Image Generation","description":"Generate ecommerce images with the Seedream 5 Pro image model. The model is fixed by this API, so provider must not be supplied in the request.","operationId":"runSeedream5ProImageGeneration","externalDocs":{"description":"Seedream 5 Pro Image Generation documentation","url":"https://www.nexscope.ai/api-docs/seedream-5-pro-image-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate ecommerce images with the Seedream 5 Pro image model.","properties":{"imageUrls":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs required by this image generation API. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.","example":["https://example.com/product.jpg"],"minItems":1,"maxItems":10},"prompt":{"type":"string","description":"Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.","example":"Keep the product consistent and generate a clean white-background ecommerce hero image.","maxLength":5000},"outputNum":{"type":"integer","description":"Number of images to generate. Valid range: 1 to 10; defaults to 1.","example":1,"minimum":1,"maximum":10},"resolution":{"type":"string","description":"Output resolution. Supported values: 1K or 2K; defaults to 1K.","example":"1K"},"aspectRatio":{"type":"string","description":"Output aspect ratio. Supported values: 1:1, 3:4, 4:3, 9:16, 16:9, 3:2, 2:3, 21:9.","example":"1:1"}},"required":["imageUrls","prompt"],"example":{"imageUrls":["https://example.com/product.jpg"],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"1K","aspectRatio":"1:1"},"additionalProperties":true},"example":{"imageUrls":["https://example.com/product.jpg"],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"1K","aspectRatio":"1:1"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seedream-5-pro-image-generation","x-nexscope-mcp-tool-name":"nexscope_seedream_5_pro_image_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/gpt-image-2-generation/run":{"post":{"tags":["Image Generation Models"],"summary":"GPT Image 2 Generation","description":"Generate ecommerce images with the GPT Image 2 model and optional quality control. The model is fixed by this API, so provider must not be supplied in the request.","operationId":"runGptImage2Generation","externalDocs":{"description":"GPT Image 2 Generation documentation","url":"https://www.nexscope.ai/api-docs/gpt-image-2-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate ecommerce images with the GPT Image 2 model and optional quality control.","properties":{"imageUrls":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs required by this image generation API. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.","example":["https://example.com/product.jpg"],"minItems":1,"maxItems":10},"prompt":{"type":"string","description":"Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.","example":"Keep the product consistent and generate a clean white-background ecommerce hero image.","maxLength":5000},"outputNum":{"type":"integer","description":"Number of images to generate. Valid range: 1 to 10; defaults to 1.","example":1,"minimum":1,"maximum":10},"resolution":{"type":"string","description":"Output resolution. Supported values: 1K, 2K, or 4K; defaults to 1K.","example":"1K"},"aspectRatio":{"type":"string","description":"Output aspect ratio. Supported values: 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21.","example":"1:1"},"quality":{"type":"string","description":"GPT Image quality. Supported values: low, medium, or high; defaults to medium.","example":"medium"}},"required":["imageUrls","prompt"],"example":{"imageUrls":["https://example.com/product.jpg"],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"1K","aspectRatio":"1:1","quality":"medium"},"additionalProperties":true},"example":{"imageUrls":["https://example.com/product.jpg"],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"1K","aspectRatio":"1:1","quality":"medium"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"gpt-image-2-generation","x-nexscope-mcp-tool-name":"nexscope_gpt_image_2_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seedance-2-0-video-generation/run":{"post":{"tags":["Video Generation Models"],"summary":"Seedance 2.0 Video Generation","description":"Generate a video with Seedance 2.0 using a primary image, up to 9 reference images, or a reference video. The model is fixed by this API, so videoType must not be supplied in the request.","operationId":"runSeedance20VideoGeneration","externalDocs":{"description":"Seedance 2.0 Video Generation documentation","url":"https://www.nexscope.ai/api-docs/seedance-2-0-video-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate a video with Seedance 2.0 using a primary image, up to 9 reference images, or a reference video.","properties":{"videoTime":{"type":"integer","description":"Video duration in seconds. Supported values: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.","example":10},"prompt":{"type":"string","description":"Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.","example":"Keep the product consistent while the camera slowly orbits and highlights material details.","maxLength":2000},"promptOptimizer":{"type":"boolean","description":"Whether Nexscope should optimize the video prompt before generation. Defaults to false.","example":false},"isPro":{"type":"boolean","description":"Whether to use the model's professional generation mode when supported. Defaults to false.","example":false},"resolution":{"type":"string","description":"Output resolution. Supported values: 480p, 720p, 1080p.","example":"720p"},"imageUrl":{"type":"string","description":"Public URL of a first-frame or primary reference image. Each image must be between 300 and 6000 pixels in both width and height.","example":"https://example.com/source-image.jpg"},"imageList":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs. Provide 1 to 9 images. Each image must be between 300 and 6000 pixels in both width and height.","example":["https://example.com/product.jpg","https://example.com/ref-2.jpg"],"minItems":1,"maxItems":9},"video":{"type":"array","items":{"type":"string"},"description":"Optional public reference-video URL list. Reference-video mode cannot be combined with image references or a final-frame image.","example":["https://example.com/reference-video.mp4"],"minItems":1},"aspectRatio":{"type":"string","description":"Target video aspect ratio supported by this model. Supported values: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive.","example":"16:9"}},"required":["videoTime","prompt"],"example":{"videoTime":10,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"720p"},"additionalProperties":true},"example":{"videoTime":10,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"720p"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seedance-2-0-video-generation","x-nexscope-mcp-tool-name":"nexscope_seedance_2_0_video_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seedance-2-0-fast-video-generation/run":{"post":{"tags":["Video Generation Models"],"summary":"Seedance 2.0 Fast Video Generation","description":"Generate a faster Seedance 2.0 video using a primary image, up to 9 reference images, or a reference video. The model is fixed by this API, so videoType must not be supplied in the request.","operationId":"runSeedance20FastVideoGeneration","externalDocs":{"description":"Seedance 2.0 Fast Video Generation documentation","url":"https://www.nexscope.ai/api-docs/seedance-2-0-fast-video-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate a faster Seedance 2.0 video using a primary image, up to 9 reference images, or a reference video.","properties":{"videoTime":{"type":"integer","description":"Video duration in seconds. Supported values: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.","example":10},"prompt":{"type":"string","description":"Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.","example":"Keep the product consistent while the camera slowly orbits and highlights material details.","maxLength":2000},"promptOptimizer":{"type":"boolean","description":"Whether Nexscope should optimize the video prompt before generation. Defaults to false.","example":false},"isPro":{"type":"boolean","description":"Whether to use the model's professional generation mode when supported. Defaults to false.","example":false},"resolution":{"type":"string","description":"Output resolution. Supported values: 480p, 720p.","example":"720p"},"imageUrl":{"type":"string","description":"Public URL of a first-frame or primary reference image. Each image must be between 300 and 6000 pixels in both width and height.","example":"https://example.com/source-image.jpg"},"imageList":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs. Provide 1 to 9 images. Each image must be between 300 and 6000 pixels in both width and height.","example":["https://example.com/product.jpg","https://example.com/ref-2.jpg"],"minItems":1,"maxItems":9},"video":{"type":"array","items":{"type":"string"},"description":"Optional public reference-video URL list. Reference-video mode cannot be combined with image references or a final-frame image.","example":["https://example.com/reference-video.mp4"],"minItems":1},"aspectRatio":{"type":"string","description":"Target video aspect ratio supported by this model. Supported values: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive.","example":"16:9"}},"required":["videoTime","prompt"],"example":{"videoTime":10,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"720p"},"additionalProperties":true},"example":{"videoTime":10,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"720p"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seedance-2-0-fast-video-generation","x-nexscope-mcp-tool-name":"nexscope_seedance_2_0_fast_video_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seedance-2-0-mini-video-generation/run":{"post":{"tags":["Video Generation Models"],"summary":"Seedance 2.0 Mini Video Generation","description":"Generate a compact Seedance 2.0 video using a primary image, up to 9 reference images, or a reference video. The model is fixed by this API, so videoType must not be supplied in the request.","operationId":"runSeedance20MiniVideoGeneration","externalDocs":{"description":"Seedance 2.0 Mini Video Generation documentation","url":"https://www.nexscope.ai/api-docs/seedance-2-0-mini-video-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate a compact Seedance 2.0 video using a primary image, up to 9 reference images, or a reference video.","properties":{"videoTime":{"type":"integer","description":"Video duration in seconds. Supported values: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.","example":10},"prompt":{"type":"string","description":"Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.","example":"Keep the product consistent while the camera slowly orbits and highlights material details.","maxLength":2000},"promptOptimizer":{"type":"boolean","description":"Whether Nexscope should optimize the video prompt before generation. Defaults to false.","example":false},"isPro":{"type":"boolean","description":"Whether to use the model's professional generation mode when supported. Defaults to false.","example":false},"resolution":{"type":"string","description":"Output resolution. Supported values: 480p, 720p.","example":"720p"},"imageUrl":{"type":"string","description":"Public URL of a first-frame or primary reference image. Each image must be between 300 and 6000 pixels in both width and height.","example":"https://example.com/source-image.jpg"},"imageList":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs. Provide 1 to 9 images. Each image must be between 300 and 6000 pixels in both width and height.","example":["https://example.com/product.jpg","https://example.com/ref-2.jpg"],"minItems":1,"maxItems":9},"video":{"type":"array","items":{"type":"string"},"description":"Optional public reference-video URL list. Reference-video mode cannot be combined with image references or a final-frame image.","example":["https://example.com/reference-video.mp4"],"minItems":1},"aspectRatio":{"type":"string","description":"Target video aspect ratio supported by this model. Supported values: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive.","example":"16:9"}},"required":["videoTime","prompt"],"example":{"videoTime":10,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"720p"},"additionalProperties":true},"example":{"videoTime":10,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"720p"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seedance-2-0-mini-video-generation","x-nexscope-mcp-tool-name":"nexscope_seedance_2_0_mini_video_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seedance-2-5-video-generation/run":{"post":{"tags":["Video Generation Models"],"summary":"Seedance 2.5 Video Generation","description":"Generate a Seedance 2.5 video using a primary image, up to 30 reference images, or a reference video. The model is fixed by this API, so videoType must not be supplied in the request.","operationId":"runSeedance25VideoGeneration","externalDocs":{"description":"Seedance 2.5 Video Generation documentation","url":"https://www.nexscope.ai/api-docs/seedance-2-5-video-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate a Seedance 2.5 video using a primary image, up to 30 reference images, or a reference video.","properties":{"videoTime":{"type":"integer","description":"Video duration in seconds. Supported values: any integer from 4 through 30.","example":5},"prompt":{"type":"string","description":"Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.","example":"Keep the product consistent while the camera slowly orbits and highlights material details.","maxLength":2000},"promptOptimizer":{"type":"boolean","description":"Whether Nexscope should optimize the video prompt before generation. Defaults to false.","example":false},"isPro":{"type":"boolean","description":"Whether to use the model's professional generation mode when supported. Defaults to false.","example":false},"resolution":{"type":"string","description":"Output resolution. Supported values: 480p, 720p, 1080p.","example":"480p"},"imageUrl":{"type":"string","description":"Public URL of a first-frame or primary reference image. Each image must be between 300 and 6000 pixels in both width and height.","example":"https://example.com/source-image.jpg"},"imageList":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs. Provide 1 to 30 images. Each image must be between 300 and 6000 pixels in both width and height.","example":["https://example.com/product.jpg","https://example.com/ref-2.jpg"],"minItems":1,"maxItems":30},"video":{"type":"array","items":{"type":"string"},"description":"Optional public reference-video URL list. Reference-video mode cannot be combined with image references or a final-frame image.","example":["https://example.com/reference-video.mp4"],"minItems":1},"aspectRatio":{"type":"string","description":"Target video aspect ratio supported by this model. Supported values: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9.","example":"16:9"}},"required":["videoTime","prompt"],"example":{"videoTime":5,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"480p"},"additionalProperties":true},"example":{"videoTime":5,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"480p"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seedance-2-5-video-generation","x-nexscope-mcp-tool-name":"nexscope_seedance_2_5_video_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/kling-2-6-video-generation/run":{"post":{"tags":["Video Generation Models"],"summary":"Kling 2.6 Video Generation","description":"Generate a Kling 2.6 video using a first frame, first/last frames, or up to 2 reference images. The model is fixed by this API, so videoType must not be supplied in the request.","operationId":"runKling26VideoGeneration","externalDocs":{"description":"Kling 2.6 Video Generation documentation","url":"https://www.nexscope.ai/api-docs/kling-2-6-video-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate a Kling 2.6 video using a first frame, first/last frames, or up to 2 reference images.","properties":{"videoTime":{"type":"integer","description":"Video duration in seconds. Supported values: 5, 10.","example":10},"prompt":{"type":"string","description":"Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.","example":"Keep the product consistent while the camera slowly orbits and highlights material details.","maxLength":2000},"promptOptimizer":{"type":"boolean","description":"Whether Nexscope should optimize the video prompt before generation. Defaults to false.","example":false},"isPro":{"type":"boolean","description":"Whether to use the model's professional generation mode when supported. Defaults to false.","example":false},"resolution":{"type":"string","description":"Output resolution. Supported values: 720p, 1080p.","example":"1080p"},"imageUrl":{"type":"string","description":"Public URL of a first-frame or primary reference image.","example":"https://example.com/source-image.jpg"},"imageList":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs. Provide 1 to 2 images.","example":["https://example.com/product.jpg","https://example.com/ref-2.jpg"],"minItems":1,"maxItems":2},"aspectRatio":{"type":"string","description":"Target video aspect ratio supported by this model. Supported values: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9.","example":"16:9"},"lastFrameImageUrl":{"type":"string","description":"Optional public URL of the final-frame image. Requires 1080p.","example":"https://example.com/last-frame.jpg"}},"required":["videoTime","prompt"],"example":{"videoTime":10,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"1080p"},"additionalProperties":true},"example":{"videoTime":10,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"1080p"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"kling-2-6-video-generation","x-nexscope-mcp-tool-name":"nexscope_kling_2_6_video_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/kling-3-omni-video-generation/run":{"post":{"tags":["Video Generation Models"],"summary":"Kling 3 Omni Video Generation","description":"Generate a Kling 3 Omni video using first/last frames or up to 7 reference images. The model is fixed by this API, so videoType must not be supplied in the request.","operationId":"runKling3OmniVideoGeneration","externalDocs":{"description":"Kling 3 Omni Video Generation documentation","url":"https://www.nexscope.ai/api-docs/kling-3-omni-video-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate a Kling 3 Omni video using first/last frames or up to 7 reference images.","properties":{"videoTime":{"type":"integer","description":"Video duration in seconds. Supported values: 5, 10, 15.","example":10},"prompt":{"type":"string","description":"Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.","example":"Keep the product consistent while the camera slowly orbits and highlights material details.","maxLength":2000},"promptOptimizer":{"type":"boolean","description":"Whether Nexscope should optimize the video prompt before generation. Defaults to false.","example":false},"isPro":{"type":"boolean","description":"Whether to use the model's professional generation mode when supported. Defaults to false.","example":false},"resolution":{"type":"string","description":"Output resolution. Supported values: 720p, 1080p.","example":"1080p"},"imageUrl":{"type":"string","description":"Public URL of a first-frame or primary reference image.","example":"https://example.com/source-image.jpg"},"imageList":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs. Provide 1 to 7 images.","example":["https://example.com/product.jpg","https://example.com/ref-2.jpg"],"minItems":1,"maxItems":7},"aspectRatio":{"type":"string","description":"Target video aspect ratio supported by this model. Supported values: 1:1, 9:16, 16:9.","example":"1:1"},"lastFrameImageUrl":{"type":"string","description":"Optional public URL of the final-frame image. Requires 1080p and cannot be combined with voice=true.","example":"https://example.com/last-frame.jpg"}},"required":["videoTime","prompt"],"example":{"videoTime":10,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"1080p"},"additionalProperties":true},"example":{"videoTime":10,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"1080p"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"kling-3-omni-video-generation","x-nexscope-mcp-tool-name":"nexscope_kling_3_omni_video_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/wan-2-6-video-generation/run":{"post":{"tags":["Video Generation Models"],"summary":"Wan 2.6 Video Generation","description":"Generate a Wan 2.6 video from a required primary image with optional camera control. The model is fixed by this API, so videoType must not be supplied in the request.","operationId":"runWan26VideoGeneration","externalDocs":{"description":"Wan 2.6 Video Generation documentation","url":"https://www.nexscope.ai/api-docs/wan-2-6-video-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate a Wan 2.6 video from a required primary image with optional camera control.","properties":{"videoTime":{"type":"integer","description":"Video duration in seconds. Supported values: 5, 10, 15.","example":10},"prompt":{"type":"string","description":"Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.","example":"Keep the product consistent while the camera slowly orbits and highlights material details.","maxLength":2000},"promptOptimizer":{"type":"boolean","description":"Whether Nexscope should optimize the video prompt before generation. Defaults to false.","example":false},"isPro":{"type":"boolean","description":"Whether to use the model's professional generation mode when supported. Defaults to false.","example":false},"resolution":{"type":"string","description":"Output resolution. Supported values: 720p, 1080p.","example":"1080p"},"imageUrl":{"type":"string","description":"Public URL of the required first-frame or primary reference image.","example":"https://example.com/source-image.jpg"},"camera":{"type":"string","description":"Camera mode. Supported values: single or multi.","example":"single"}},"required":["videoTime","prompt","imageUrl"],"example":{"videoTime":10,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"1080p"},"additionalProperties":true},"example":{"videoTime":10,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"1080p"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"wan-2-6-video-generation","x-nexscope-mcp-tool-name":"nexscope_wan_2_6_video_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/hailuo-2-3-video-generation/run":{"post":{"tags":["Video Generation Models"],"summary":"Hailuo 2.3 Video Generation","description":"Generate a Hailuo 2.3 video from a required primary image; the aspect ratio is adaptive. The model is fixed by this API, so videoType must not be supplied in the request.","operationId":"runHailuo23VideoGeneration","externalDocs":{"description":"Hailuo 2.3 Video Generation documentation","url":"https://www.nexscope.ai/api-docs/hailuo-2-3-video-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate a Hailuo 2.3 video from a required primary image; the aspect ratio is adaptive.","properties":{"videoTime":{"type":"integer","description":"Video duration in seconds. Supported values: 6, 10.","example":6},"prompt":{"type":"string","description":"Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.","example":"Keep the product consistent while the camera slowly orbits and highlights material details.","maxLength":2000},"promptOptimizer":{"type":"boolean","description":"Whether Nexscope should optimize the video prompt before generation. Defaults to false.","example":false},"isPro":{"type":"boolean","description":"Whether to use the model's professional generation mode when supported. Defaults to false.","example":false},"resolution":{"type":"string","description":"Output resolution. Supported values: 768p, 1080p.","example":"1080p"},"imageUrl":{"type":"string","description":"Public URL of the required first-frame or primary reference image.","example":"https://example.com/source-image.jpg"}},"required":["videoTime","prompt","resolution","imageUrl"],"example":{"videoTime":6,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"1080p"},"additionalProperties":true},"example":{"videoTime":6,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"1080p"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"hailuo-2-3-video-generation","x-nexscope-mcp-tool-name":"nexscope_hailuo_2_3_video_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/happy-horse-2-video-generation/run":{"post":{"tags":["Video Generation Models"],"summary":"Happy Horse 2 Video Generation","description":"Generate a Happy Horse 2 video from 1 to 9 required reference images. The model is fixed by this API, so videoType must not be supplied in the request.","operationId":"runHappyHorse2VideoGeneration","externalDocs":{"description":"Happy Horse 2 Video Generation documentation","url":"https://www.nexscope.ai/api-docs/happy-horse-2-video-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate a Happy Horse 2 video from 1 to 9 required reference images.","properties":{"videoTime":{"type":"integer","description":"Video duration in seconds. Supported values: 5, 10, 15.","example":10},"prompt":{"type":"string","description":"Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.","example":"Keep the product consistent while the camera slowly orbits and highlights material details.","maxLength":2000},"promptOptimizer":{"type":"boolean","description":"Whether Nexscope should optimize the video prompt before generation. Defaults to false.","example":false},"isPro":{"type":"boolean","description":"Whether to use the model's professional generation mode when supported. Defaults to false.","example":false},"resolution":{"type":"string","description":"Output resolution. Supported values: 720p, 1080p.","example":"1080p"},"imageList":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs. Provide 1 to 9 images.","example":["https://example.com/product.jpg","https://example.com/ref-2.jpg"],"minItems":1,"maxItems":9},"aspectRatio":{"type":"string","description":"Target video aspect ratio supported by this model. Supported values: 9:16, 16:9.","example":"9:16"}},"required":["videoTime","prompt","resolution","imageList"],"example":{"videoTime":10,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageList":["https://example.com/product.jpg","https://example.com/ref-2.jpg"],"resolution":"1080p"},"additionalProperties":true},"example":{"videoTime":10,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageList":["https://example.com/product.jpg","https://example.com/ref-2.jpg"],"resolution":"1080p"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"happy-horse-2-video-generation","x-nexscope-mcp-tool-name":"nexscope_happy_horse_2_video_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ozon-brand-products/run":{"post":{"tags":["Ozon Marketplace"],"summary":"Ozon Brand Products","description":"Nexscope Ozon Russia brand drill-down product list. Returns all products under an Ozon brand display name (Russian/Latin) with complete metrics: sales, revenue, price, rating, stock, turnover, lost revenue, supporting multi-dimensional numeric filters, sorting, and currency conversion. Use for brand benchmarking, competitor analysis, brand product structure research, SKU-level bestseller analysis. Trigger when the user mentions Ozon brand drill-down, Ozon brand products, Ozon competitor brand analysis, brand structure, brand SKUs, brand bestsellers, Ozon brand sales, Nexscope brand, Ozon brand products, brand drill-down, brand competitor analysis, Russian marketplace brand SKUs, brand revenue share. Also trigger when the intent is to view all products and their sales/price/rating performance under an Ozon brand, even without explicitly mentioning Nexscope.","operationId":"runOzonBrandProducts","externalDocs":{"description":"Ozon Brand Products documentation","url":"https://www.nexscope.ai/api-docs/ozon-brand-products"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.ozon-brand-products.","properties":{"brandName":{"type":"string","description":"Ozon brand display name (Russian or Latin)","example":"COMMO"},"startDate":{"type":"string","description":"Statistics start date, YYYY-MM-DD; latest is yesterday","example":"2026-01-01"},"endDate":{"type":"string","description":"Statistics end date, YYYY-MM-DD; latest is yesterday","example":"2026-01-01"},"page":{"type":"integer","description":"Page number, starting from 1","example":1},"pageSize":{"type":"integer","description":"Rows per page, 1-100, default 100","example":10},"sortField":{"type":"string","description":"Sort column name (snake_case), e.g., sales, revenue, final_price, balance, rating"},"sortDirection":{"type":"string","description":"asc ascending / desc descending"},"currency":{"type":"string","description":"Currency code for result amounts, default RUB, e.g., USD / EUR / CNY"},"currencyRate":{"type":"integer","description":"Custom exchange rate (for non-default currency)","example":1},"includeFbs":{"type":"boolean","description":"Whether to include FBS data","example":false},"filters":{"type":"array","items":{},"description":"List of numeric filter conditions, each {field, op, value, value2?}, multiple conditions AND","example":[]}},"required":["brandName"],"example":{"startDate":"2026-01-01","currencyRate":1,"brandName":"COMMO","page":1,"endDate":"2026-01-31","pageSize":10,"includeFbs":false},"additionalProperties":true},"example":{"startDate":"2026-01-01","currencyRate":1,"brandName":"COMMO","page":1,"endDate":"2026-01-31","pageSize":10,"includeFbs":false}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total number of matched products under the brand","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list (see details below)","example":[],"items":{"type":"object","properties":{"productId":{"type":"integer","description":"SKU ID","example":1},"title":{"type":"string","description":"Product name (Russian)","example":null},"brand":{"type":"string","description":"Brand","example":null},"brandId":{"type":"integer","description":"Brand ID","example":1},"sellerName":{"type":"string","description":"Seller name","example":null},"sellerId":{"type":"integer","description":"Seller ID","example":1},"category":{"type":"string","description":"Category path (Russian, / separated)","example":null},"nicheName":{"type":"string","description":"Niche path (Russian)","example":null},"nicheId":{"type":"integer","description":"Niche ID","example":1},"country":{"type":"string","description":"Country of sale, always RU for Ozon","example":null},"firstDate":{"type":"string","description":"Listing date (yyyy-MM-dd)","example":"2026-01-01"},"imageUrl":{"type":"string","description":"Main image URL","example":"https://example.com/image.jpg"},"productPageUrl":{"type":"string","description":"Product page URL","example":"https://example.com/image.jpg"},"sourceTool":{"type":"string","description":"Source tool identifier","example":null},"sourceType":{"type":"string","description":"Data source identifier","example":null},"price":{"type":"number","description":"Current selling price","example":1},"oldPrice":{"type":"number","description":"Original price before discount","example":1},"ozonCardPrice":{"type":"number","description":"Ozon Card price","example":1},"minPrice":{"type":"number","description":"Minimum price during the statistics period","example":1},"maxPrice":{"type":"number","description":"Maximum price during the statistics period","example":1},"averagePrice":{"type":"number","description":"Average price during the statistics period","example":1},"currency":{"type":"string","description":"Currency symbol (₽ / $ / €)","example":null},"rating":{"type":"number","description":"Rating, 0-5","example":1},"reviewCount":{"type":"integer","description":"Number of reviews","example":1},"balance":{"type":"integer","description":"Current stock (units)","example":1},"balanceFbs":{"type":"integer","description":"FBS stock (seller self-ship units)","example":1},"frozenStocks":{"type":"integer","description":"Slow-moving stock","example":1},"warehousesCount":{"type":"integer","description":"Number of FBO warehouses","example":1},"isFbs":{"type":"boolean","description":"Whether shipped via FBS","example":false},"salesPerDay":{"type":"number","description":"Average daily sales (units/day)","example":1},"monthlySalesUnits":{"type":"integer","description":"Sales volume during the statistics period (units)","example":1},"monthlySalesRevenue":{"type":"number","description":"Sales revenue during the statistics period","example":1},"lostProfit":{"type":"number","description":"Lost revenue (due to stockouts, etc.)","example":1},"daysInSite":{"type":"integer","description":"Days on sale (statistics period, including out-of-stock days)","example":1},"daysInStock":{"type":"integer","description":"Days in stock","example":1},"turnoverDays":{"type":"number","description":"Turnover days (lower is faster)","example":1},"position":{"type":"integer","description":"Ranking within the current query dimension (brand for this endpoint)","example":1},"categoryPosition":{"type":"integer","description":"Ranking within the category","example":1},"revenueSharePercent":{"type":"number","description":"Revenue share of this SKU within the current query dimension, 0-100","example":1}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered column definitions","example":[]},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"API latency (milliseconds)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Response type","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"productId":1,"brandId":1,"sellerId":1,"nicheId":1,"firstDate":"2026-01-01","imageUrl":"https://example.com/image.jpg","productPageUrl":"https://example.com/image.jpg","price":1,"oldPrice":1,"ozonCardPrice":1,"minPrice":1,"maxPrice":1,"averagePrice":1,"rating":1,"reviewCount":1,"balance":1,"balanceFbs":1,"frozenStocks":1,"warehousesCount":1,"isFbs":false,"salesPerDay":1,"monthlySalesUnits":1,"monthlySalesRevenue":1,"lostProfit":1,"daysInSite":1,"daysInStock":1,"turnoverDays":1,"position":1,"categoryPosition":1,"revenueSharePercent":1}],"columns":[],"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ozon-brand-products","x-nexscope-mcp-tool-name":"nexscope_ozon_brand_products","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ozon-category-products/run":{"post":{"tags":["Ozon Marketplace"],"summary":"Ozon Category Products","description":"Nexscope Ozon Russia category drill-down product list by Russian category path. Returns all products in a category with complete metrics: sales, revenue, price, rating, stock, turnover, lost revenue, supporting multi-dimensional numeric filters, sorting, and currency conversion. Use for category bestseller mining, blue-ocean insight discovery, category ranking analysis, brand landscape observation. Trigger when the user mentions Ozon category drill-down, Ozon category products, Ozon blue-ocean mining, Ozon category bestsellers, Ozon category ranking, Ozon subcategory structure, Ozon niche SKUs, Nexscope category, Ozon category drill-down, Russian marketplace niche, Ozon niche mining, Ozon subcategory bestseller. Also trigger when the intent is to view all products and their sales/price/ranking performance under an Ozon category path, even without explicitly mentioning Nexscope.","operationId":"runOzonCategoryProducts","externalDocs":{"description":"Ozon Category Products documentation","url":"https://www.nexscope.ai/api-docs/ozon-category-products"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.ozon-category-products.","properties":{"categoryPath":{"type":"string","description":"Full Ozon Russian category path, levels separated by /, e.g., Одежда/Женская одежда/Футболки и топы женские","example":"Электроника/Телефоны и смарт-часы/Аксессуары для смартфонов и телефонов/Чехлы для смартфонов"},"startDate":{"type":"string","description":"Statistics start date YYYY-MM-DD; latest is yesterday","example":"2026-01-01"},"endDate":{"type":"string","description":"Statistics end date YYYY-MM-DD; latest is yesterday","example":"2026-01-01"},"page":{"type":"integer","description":"Page number, starting from 1","example":1},"pageSize":{"type":"integer","description":"Rows per page 1-100, default 100","example":10},"sortField":{"type":"string","description":"Sort column name (snake_case), e.g., sales, revenue, final_price, balance, rating"},"sortDirection":{"type":"string","description":"asc / desc"},"currency":{"type":"string","description":"Currency code, default RUB, e.g., USD"},"currencyRate":{"type":"integer","description":"Custom exchange rate (for non-default currency)","example":1},"includeFbs":{"type":"boolean","description":"Whether to include FBS data","example":false},"filters":{"type":"array","items":{},"description":"List of numeric filter conditions, each {field, op, value, value2?}, multiple conditions AND","example":[]}},"required":["categoryPath"],"example":{"startDate":"2026-07-01","currencyRate":1,"page":1,"endDate":"2026-07-31","categoryPath":"Электроника/Телефоны и смарт-часы/Аксессуары для смартфонов и телефонов/Чехлы для смартфонов","pageSize":10,"includeFbs":false},"additionalProperties":true},"example":{"startDate":"2026-07-01","currencyRate":1,"page":1,"endDate":"2026-07-31","categoryPath":"Электроника/Телефоны и смарт-часы/Аксессуары для смартфонов и телефонов/Чехлы для смартфонов","pageSize":10,"includeFbs":false}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total number of matched products under the category","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list (see details below)","example":[],"items":{"type":"object","properties":{"productId":{"type":"integer","description":"SKU ID","example":1},"title":{"type":"string","description":"Product name (Russian)","example":null},"brand":{"type":"string","description":"Brand","example":null},"brandId":{"type":"integer","description":"Brand ID","example":1},"sellerName":{"type":"string","description":"Seller name","example":null},"sellerId":{"type":"integer","description":"Seller ID","example":1},"category":{"type":"string","description":"Category path (Russian, / separated)","example":null},"nicheName":{"type":"string","description":"Niche path (Russian)","example":null},"nicheId":{"type":"integer","description":"Niche ID","example":1},"country":{"type":"string","description":"Country of sale, always RU for Ozon","example":null},"firstDate":{"type":"string","description":"Listing date (yyyy-MM-dd)","example":"2026-01-01"},"imageUrl":{"type":"string","description":"Main image URL","example":"https://example.com/image.jpg"},"productPageUrl":{"type":"string","description":"Product page URL","example":"https://example.com/image.jpg"},"sourceTool":{"type":"string","description":"Source tool identifier","example":null},"sourceType":{"type":"string","description":"Data source identifier","example":null},"price":{"type":"number","description":"Current selling price","example":1},"oldPrice":{"type":"number","description":"Original price before discount","example":1},"ozonCardPrice":{"type":"number","description":"Ozon Card price","example":1},"minPrice":{"type":"number","description":"Minimum price during the statistics period","example":1},"maxPrice":{"type":"number","description":"Maximum price during the statistics period","example":1},"averagePrice":{"type":"number","description":"Average price during the statistics period","example":1},"currency":{"type":"string","description":"Currency symbol (₽ / $ / €)","example":null},"rating":{"type":"number","description":"Rating, 0-5","example":1},"reviewCount":{"type":"integer","description":"Number of reviews","example":1},"balance":{"type":"integer","description":"Current stock (units)","example":1},"balanceFbs":{"type":"integer","description":"FBS stock (seller self-ship units)","example":1},"frozenStocks":{"type":"integer","description":"Slow-moving stock","example":1},"warehousesCount":{"type":"integer","description":"Number of FBO warehouses","example":1},"isFbs":{"type":"boolean","description":"Whether shipped via FBS","example":false},"salesPerDay":{"type":"number","description":"Average daily sales (units/day)","example":1},"monthlySalesUnits":{"type":"integer","description":"Sales volume during the statistics period (units)","example":1},"monthlySalesRevenue":{"type":"number","description":"Sales revenue during the statistics period","example":1},"lostProfit":{"type":"number","description":"Lost revenue (due to stockouts, etc.)","example":1},"daysInSite":{"type":"integer","description":"Days on sale (statistics period, including out-of-stock days)","example":1},"daysInStock":{"type":"integer","description":"Days in stock","example":1},"turnoverDays":{"type":"number","description":"Turnover days (lower is faster)","example":1},"position":{"type":"integer","description":"Ranking within the current query dimension (category for this endpoint)","example":1},"categoryPosition":{"type":"integer","description":"Ranking within the category","example":1},"revenueSharePercent":{"type":"number","description":"Revenue share of this SKU within the current query dimension, 0-100","example":1}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered column definitions","example":[]},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"API latency (milliseconds)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Response type","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"productId":1,"brandId":1,"sellerId":1,"nicheId":1,"firstDate":"2026-01-01","imageUrl":"https://example.com/image.jpg","productPageUrl":"https://example.com/image.jpg","price":1,"oldPrice":1,"ozonCardPrice":1,"minPrice":1,"maxPrice":1,"averagePrice":1,"rating":1,"reviewCount":1,"balance":1,"balanceFbs":1,"frozenStocks":1,"warehousesCount":1,"isFbs":false,"salesPerDay":1,"monthlySalesUnits":1,"monthlySalesRevenue":1,"lostProfit":1,"daysInSite":1,"daysInStock":1,"turnoverDays":1,"position":1,"categoryPosition":1,"revenueSharePercent":1}],"columns":[],"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ozon-category-products","x-nexscope-mcp-tool-name":"nexscope_ozon_category_products","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ozon-category-search/run":{"post":{"tags":["Ozon Marketplace"],"summary":"Ozon Category Search","description":"Nexscope Ozon category product search: fetches the product list for a given Ozon category ID, returning category-level aggregates (total sales, total revenue, average price, average rating, seasonality) and per-product sales, price, rating, review count, brand, seller, and fulfillment method. Use for category selection analysis, category bestseller mining, category capacity and price band analysis, seasonality assessment. Trigger when the user mentions Ozon category products, Ozon category analysis, Ozon category selection, Ozon category bestsellers, Ozon category total sales, Ozon category average price, Ozon category search, Ozon category products, category best-sellers, category analysis. Also trigger when the intent is to view products and category-level summary data within an Ozon category, even without explicitly mentioning Nexscope.","operationId":"runOzonCategorySearch","externalDocs":{"description":"Ozon Category Search documentation","url":"https://www.nexscope.ai/api-docs/ozon-category-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.ozon-category-search.","properties":{"categoryId":{"type":"string","description":"Ozon category ID, obtained from Ozon category documentation or other Nexscope Ozon tools. Format like 15621032_15621049_115951147 (multi-level categories joined by _)","example":"15621042_17028650_97011"},"page":{"type":"object","description":"Pagination & sorting: {page, pageSize, orders[]}","example":{"page":1,"pageSize":10},"properties":{"page":{"type":"integer","description":"Page number, starting from 1, default 1","example":1},"pageSize":{"type":"integer","description":"Items per page, default 20, maximum 20 (exceeding returns errcode 1002)","example":1},"orders":{"type":"array","items":{},"description":"Sort rules, elements {field, direction} (both required); direction takes DESC (descending) / ASC (ascending). Common sort fields: sales, price, revenue, reviewRating","example":[]}},"additionalProperties":true},"date":{"type":"string","description":"Query historical month, format yyyy-MM (e.g., 2026-02); defaults to last 30 days if omitted","example":"2026-01"},"fulfillment":{"type":"string","description":"Fulfillment method filter, fixed options: FBO, FBS, RFBS, FBP, OZON; queries all if omitted. Note: single string, not an array"},"uId":{"type":"string","description":"User ID (max 1000)","example":"example-id"},"memberId":{"type":"string","description":"Member ID (a unique member identifier; a user can belong to multiple teams; data is attributed to memberId, max 1000)","example":"example-id"}},"required":["categoryId","page"],"example":{"page":{"page":1,"pageSize":10},"categoryId":"15621042_17028650_97011","date":"2026-01"},"additionalProperties":true},"example":{"page":{"page":1,"pageSize":10},"categoryId":"15621042_17028650_97011","date":"2026-01"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","description":"Echoed category ID","example":"example-id"},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"Number of records returned on this page (equals the current page data count, not total category product count)","example":1},{"type":"null"}]},"totalSales":{"anyOf":[{"type":"integer","description":"Total category sales volume (within the statistics interval)","example":1},{"type":"null"}]},"totalRevenue":{"anyOf":[{"type":"number","description":"Total category sales revenue (RUB)","example":1},{"type":"null"}]},"avgPrice":{"anyOf":[{"type":"number","description":"Average category product price (RUB)","example":1},{"type":"null"}]},"rating":{"anyOf":[{"type":"number","description":"Average category product rating","example":1},{"type":"null"}]},"startDate":{"anyOf":[{"type":"string","description":"Statistics start date","example":"2026-01-01"},{"type":"null"}]},"endDate":{"anyOf":[{"type":"string","description":"Statistics end date","example":"2026-01-01"},{"type":"null"}]},"sellerType":{"anyOf":[{"type":"object","description":"Fulfillment method distribution (not seller domestic/cross-border type), keys are fulfillment methods and values are product counts for that method, e.g., {\"FBO\":218,\"RFBS\":528,\"FBP\":5,\"FBS\":240,\"OZON\":1}","example":{}},{"type":"null"}]},"categoryInfo":{"anyOf":[{"type":"object","description":"Category metadata, structure see \"categoryInfo Structure\" below","example":{},"properties":{"cnTitlePath":{"anyOf":[{"type":"string","description":"Chinese category path, for example Footwear > Athletic and Work Shoes > Weightlifting Shoes","example":null},{"type":"null"}]},"enTitlePath":{"anyOf":[{"type":"string","description":"English category path, e.g., Footwear > Sports and Work Footwear > Weightlifting Shoes","example":null},{"type":"null"}]},"titlePath":{"anyOf":[{"type":"string","description":"Russian (front-end) category path, e.g., Обувь > Спортивная и рабочая обувь > Штангетки","example":null},{"type":"null"}]},"fullCategoryId":{"anyOf":[{"type":"array","description":"Array of category IDs at each level, e.g., [\"15621032\",\"15621032_15621049\",\"15621032_15621049_115951147\"]","example":[]},{"type":"null"}]},"category":{"anyOf":[{"type":"object","description":"Terminal category object, containing cnTitle/enTitle/title(Russian)/level/crossBorderSellable(whether cross-border sales are allowed)/pid/disabled/id","example":{}},{"type":"null"}]}}},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Category product list (see details below)","example":[],"items":{"type":"object","properties":{"sku":{"type":"integer","description":"Product SKU","example":1},"productId":{"type":"integer","description":"Unified product ID, mapped from sku","example":1},"title":{"type":"string","description":"Product title","example":null},"price":{"type":"number","description":"Product price (RUB)","example":1},"currency":{"type":"string","description":"Currency, always ₽","example":null},"sales":{"type":"integer","description":"Product sales volume","example":1},"monthlySalesUnits":{"type":"integer","description":"Unified monthly sales, mapped from sales","example":1},"revenue":{"type":"number","description":"Product sales revenue","example":1},"monthlySalesRevenue":{"type":"number","description":"Unified monthly revenue, mapped from revenue","example":1},"reviewRating":{"type":"number","description":"Product rating","example":1},"rating":{"type":"number","description":"Unified rating, mapped from reviewRating","example":1},"reviewCount":{"type":"integer","description":"Number of reviews","example":1},"brandName":{"type":"string","description":"Brand name","example":null},"brand":{"type":"string","description":"Unified brand, mapped from brandName","example":null},"sellerName":{"type":"string","description":"Seller name","example":null},"fulfillment":{"type":"array","description":"Product fulfillment methods, e.g., [\"FBO\"], may contain multiple values","example":[]},"imageUrl":{"type":"string","description":"Product image URL","example":"https://example.com/image.jpg"},"productUrl":{"type":"string","description":"Product URL","example":"https://example.com/image.jpg"},"productPageUrl":{"type":"string","description":"Unified product page URL, mapped from productUrl","example":"https://example.com/image.jpg"},"categoryInfo":{"type":"object","description":"Product category attribution information, structure see \"categoryInfo Structure\" below","example":{}},"sourceType":{"type":"string","description":"Data source, always ozon","example":null},"sourceTool":{"type":"string","description":"Source tool identifier for the Ozon category endpoint","example":null}}}},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Category product list, content identical to data","example":[],"items":{"type":"object","properties":{"seasonalityAmplitude":{"anyOf":[{"type":"string","description":"Seasonality intensity, e.g., STRONG_SEASONALITY","example":null},{"type":"null"}]},"seasonalityCoef":{"anyOf":[{"type":"string","description":"Seasonality phase, e.g., OFF_SEASON","example":null},{"type":"null"}]},"sku":{"type":"integer","description":"Product SKU","example":1},"productId":{"type":"integer","description":"Unified product ID, mapped from sku","example":1},"title":{"type":"string","description":"Product title","example":null},"price":{"type":"number","description":"Product price (RUB)","example":1},"currency":{"type":"string","description":"Currency, always ₽","example":null},"sales":{"type":"integer","description":"Product sales volume","example":1},"monthlySalesUnits":{"type":"integer","description":"Unified monthly sales, mapped from sales","example":1},"revenue":{"type":"number","description":"Product sales revenue","example":1},"monthlySalesRevenue":{"type":"number","description":"Unified monthly revenue, mapped from revenue","example":1},"reviewRating":{"type":"number","description":"Product rating","example":1},"rating":{"type":"number","description":"Unified rating, mapped from reviewRating","example":1},"reviewCount":{"type":"integer","description":"Number of reviews","example":1},"brandName":{"type":"string","description":"Brand name","example":null},"brand":{"type":"string","description":"Unified brand, mapped from brandName","example":null},"sellerName":{"type":"string","description":"Seller name","example":null},"fulfillment":{"type":"array","description":"Product fulfillment methods, e.g., [\"FBO\"], may contain multiple values","example":[]},"imageUrl":{"type":"string","description":"Product image URL","example":"https://example.com/image.jpg"},"productUrl":{"type":"string","description":"Product URL","example":"https://example.com/image.jpg"},"productPageUrl":{"type":"string","description":"Unified product page URL, mapped from productUrl","example":"https://example.com/image.jpg"},"categoryInfo":{"type":"object","description":"Product category attribution information, structure see \"categoryInfo Structure\" below","example":{}},"sourceType":{"type":"string","description":"Data source, always ozon","example":null},"sourceTool":{"type":"string","description":"Source tool identifier for the Ozon category endpoint","example":null}}}},{"type":"null"}]},"hasNextPage":{"anyOf":[{"type":"boolean","description":"Whether there is a next page","example":false},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions, elements contain {field, title, cellType, sortable, filterable}","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Response display type","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"API latency (milliseconds)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"id":"example-id","total":1,"totalSales":1,"totalRevenue":1,"avgPrice":1,"rating":1,"startDate":"2026-01-01","endDate":"2026-01-01","sellerType":{},"categoryInfo":{"fullCategoryId":[],"category":{}},"data":[{"sku":1,"productId":1,"price":1,"sales":1,"monthlySalesUnits":1,"revenue":1,"monthlySalesRevenue":1,"reviewRating":1,"rating":1,"reviewCount":1,"fulfillment":[],"imageUrl":"https://example.com/image.jpg","productUrl":"https://example.com/image.jpg","productPageUrl":"https://example.com/image.jpg","categoryInfo":{}}],"products":[{"sku":1,"productId":1,"price":1,"sales":1,"monthlySalesUnits":1,"revenue":1,"monthlySalesRevenue":1,"reviewRating":1,"rating":1,"reviewCount":1,"fulfillment":[],"imageUrl":"https://example.com/image.jpg","productUrl":"https://example.com/image.jpg","productPageUrl":"https://example.com/image.jpg","categoryInfo":{}}],"hasNextPage":false,"columns":[],"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ozon-category-search","x-nexscope-mcp-tool-name":"nexscope_ozon_category_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ozon-keyword-back-search/run":{"post":{"tags":["Keyword & Search Demand"],"summary":"Ozon Keyword Back Search","description":"Nexscope Ozon keyword reverse lookup: reverse-looks up Ozon (and Wildberries) search keywords by a list of product SKUs (up to 20), returning which search terms those products appear under (organic/ad search terms), with multi-dimensional filtering by search volume, growth, product count, seller count, competitor count, natural rank, ad rank, exposure, conversion, cart-add conversion, etc. Each keyword carries monthly search volume, growth, market space, competitor/seller counts, average price, cart-add conversion, top products, and organic/ad channel, rank, exposure, and conversion (dimension) market profiles. Use for Ozon keyword reverse lookup, listing keyword optimization, competitor traffic word mining, and ad keyword analysis. Trigger when the user mentions Ozon keyword reverse lookup, Ozon reverse keyword search, Ozon SKU keyword reverse, Ozon product traffic keywords, Ozon competitor ranking keywords, Ozon organic/ad keyword reverse lookup, Nexscope Ozon, Ozon keyword back search, Ozon reverse keyword lookup, Ozon SKU keyword reverse. Also trigger when the intent is to reverse-lookup Ozon search keywords by product SKU and view market profiles, even without explicitly mentioning Nexscope.","operationId":"runOzonKeywordBackSearch","externalDocs":{"description":"Ozon Keyword Back Search documentation","url":"https://www.nexscope.ai/api-docs/ozon-keyword-back-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.ozon-keyword-back-search.","properties":{"skuIds":{"type":["integer","array"],"description":"List of SKUs to back-search, max 20","example":1,"items":{"type":"string"}},"hasVariant":{"type":"integer","description":"Whether to exclude variants: 0 do not exclude variants, 1 exclude variants","example":1},"page":{"type":"object","description":"Pagination & sorting: {page, pageSize, orders[]}","example":{"page":1,"pageSize":10},"properties":{"page":{"type":"integer","description":"Page number, starting from 1, default 1","example":1},"pageSize":{"type":"integer","description":"Items per page, default 20","example":1},"orders":{"type":"array","items":{},"description":"Sort rules, elements {field, direction}; direction takes DESC (descending) / ASC (ascending)","example":[]}},"additionalProperties":true},"matchType":{"type":"integer","description":"Keyword match mode: 0 exact, 1 fuzzy","example":1},"type":{"type":"array","items":{},"description":"Search term type filter, fixed options: 0 organic search terms, 1 ad search terms; no filtering if omitted","example":[]},"historyDate":{"type":"string","description":"Historical month yyyy-MM (e.g., 2026-02); can be left blank per docs to query current period","example":"2026-01-01"},"includeKeywords":{"type":"array","items":{},"description":"Include keyword array (max 1000), only returns search terms containing the specified words","example":[]},"excludeKeywords":{"type":"array","items":{},"description":"Exclude keyword array (max 1000), removes irrelevant terms","example":[]},"searchVolume":{"type":"string","description":"Monthly search volume range"},"searchChange30":{"type":"string","description":"30-day search change range"},"wordCount":{"type":"string","description":"Keyword word count range"},"productViews":{"type":"string","description":"Product views range"},"products":{"type":"string","description":"Product count range"},"sellers":{"type":"string","description":"Seller count range"},"marketSpace":{"type":"string","description":"Market space range"},"conversionSharing":{"type":"string","description":"Conversion concentration range"},"uniqQueriesWCa":{"type":"string","description":"Add-to-cart count range"},"ca":{"type":"string","description":"Add-to-cart conversion rate range"},"conversion":{"type":"string","description":"Conversion rate range"},"titleDensity":{"type":"string","description":"Title density range"},"adRivalCount":{"type":"string","description":"Ad competitor count range"},"adRank":{"type":"string","description":"Ad ranking range"},"naturalRank":{"type":"string","description":"Organic ranking range"},"exposure":{"type":"string","description":"Exposure range"},"uId":{"type":"string","description":"User ID","example":"example-id"},"memberId":{"type":"string","description":"Member ID (a unique member identifier; data is attributed to memberId)","example":"example-id"}},"required":["skuIds","hasVariant","page"],"example":{"page":{"page":1,"pageSize":10},"skuIds":["175924376"],"historyDate":"2026-01-01","type":[],"matchType":1,"hasVariant":1},"additionalProperties":true},"example":{"page":{"page":1,"pageSize":10},"skuIds":["175924376"],"historyDate":"2026-01-01","type":[],"matchType":1,"hasVariant":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total record count","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Keyword back-search data (see details below)","example":[],"items":{"type":"object","properties":{"query":{"type":"string","description":"Keyword (original Russian)","example":"phone case"},"queryCn":{"type":"string","description":"Keyword Chinese translation","example":"phone case"},"platform":{"type":"integer","description":"Platform: 0 Ozon, 1 Wildberries","example":1},"searchVolume":{"type":"integer","description":"Monthly search volume","example":1},"count30GrowthRate":{"type":"number","description":"Monthly search growth (%, can be negative)","example":1},"productCount":{"type":"integer","description":"Product count (may be missing in some rows)","example":1},"competingProducts":{"type":"integer","description":"Competing product count","example":1},"sellers":{"type":"integer","description":"Seller count","example":1},"avgPrice":{"type":"number","description":"Average price","example":1},"itemsViews":{"type":"number","description":"Product visibility","example":1},"viewSharing":{"type":"number","description":"View concentration (%)","example":1},"conversionSharing":{"type":"number","description":"Conversion concentration (%)","example":1},"marketSpace":{"type":"number","description":"Market space","example":1},"returnCancellationRate":{"type":"number","description":"Return/cancellation rate (%)","example":1},"uniqQueriesWCa":{"type":"integer","description":"Add-to-cart count","example":1},"ca":{"type":"number","description":"Add-to-cart conversion rate (%)","example":1},"titleDensity":{"type":"number","description":"Title density","example":1},"wordCount":{"type":"integer","description":"Word count","example":1},"categories":{"type":"array","description":"Category ID array","example":[]},"dimension":{"type":"object","description":"Dimension object, carrying back-search-specific metrics (see below)","example":{},"properties":{"type":{"type":"integer","description":"Search term channel: 0 organic search term, 1 ad search term","example":1},"naturalRank":{"type":"integer","description":"Organic ranking (the back-searched SKU's organic position under this term)","example":1},"exposure":{"type":"number","description":"Exposure (0–1)","example":1},"conversion":{"type":"number","description":"Conversion rate (0–1)","example":1},"x":{"type":"array","description":"Position/pagination indicator, semantics opaque","example":[]}}},"products":{"type":"array","description":"Top product data (see below)","example":[],"items":{"type":"object","properties":{"ozonId":{"type":"integer","description":"Ozon product ID","example":1},"sku":{"type":"integer","description":"SKU ID","example":1},"title":{"type":"string","description":"Product title (Russian)","example":null},"imageUrl":{"type":"string","description":"Main image URL","example":"https://example.com/image.jpg"},"advert":{"type":"integer","description":"Ad indicator (0/1)","example":1}}}},"id":{"type":"string","description":"Record ID","example":"example-id"},"categoryInfos":{"type":"array","description":"Schema-defined category information; current supplier examples omit it","example":[],"items":{"type":"object","properties":{"titleCn":{"type":"string","description":"Category Chinese name","example":null},"titleEn":{"type":"string","description":"Category English name","example":null},"titleRu":{"type":"string","description":"Category Russian name","example":null},"cnTitlePath":{"type":"string","description":"Chinese category path","example":null},"enTitlePath":{"type":"string","description":"English category path","example":null},"titlePath":{"type":"string","description":"Russian category path","example":null},"id":{"type":"string","description":"Category ID","example":"example-id"},"crossBorderSellable":{"type":"boolean","description":"Whether cross-border sales are allowed","example":false}}}}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions, elements contain {field, title, cellType, sortable, filterable}","example":[]},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"API latency (milliseconds)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Response display type, e.g., tableListWorkbenches","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"query":"phone case","queryCn":"phone case","platform":1,"searchVolume":1,"count30GrowthRate":1,"productCount":1,"competingProducts":1,"sellers":1,"avgPrice":1,"itemsViews":1,"viewSharing":1,"conversionSharing":1,"marketSpace":1,"returnCancellationRate":1,"uniqQueriesWCa":1,"ca":1,"titleDensity":1,"wordCount":1,"categories":[],"dimension":{"type":1,"naturalRank":1,"exposure":1,"conversion":1,"x":[]},"products":[{"ozonId":1,"sku":1,"imageUrl":"https://example.com/image.jpg","advert":1}],"id":"example-id","categoryInfos":[{"id":"example-id","crossBorderSellable":false}]}],"columns":[],"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ozon-keyword-back-search","x-nexscope-mcp-tool-name":"nexscope_ozon_keyword_back_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ozon-keyword-mining/run":{"post":{"tags":["Keyword & Search Demand"],"summary":"Ozon Keyword Mining","description":"Nexscope Ozon keyword mining: mines Ozon (and Wildberries) related keywords around a seed keyword with multi-dimensional filtering by search volume, growth, product count, seller count, competitor count, price, relevancy, title density, cart-add conversion, etc. Each mined keyword carries a full market profile (monthly search volume, growth, market space, competitor/seller counts, average price, cart-add conversion, top products). Use for Ozon keyword expansion, long-tail keyword mining, and seed keyword opportunity analysis. Trigger when the user mentions Ozon keyword mining, Ozon keyword expansion, Ozon long-tail keyword mining, find related keywords around a term, Ozon blue-ocean keyword mining, Nexscope Ozon, Ozon keyword mining, Ozon keyword expansion, Ozon related keywords, mine Ozon keywords. Also trigger when the intent is to mine Ozon related keywords around a seed term and view market profiles, even without explicitly mentioning Nexscope.","operationId":"runOzonKeywordMining","externalDocs":{"description":"Ozon Keyword Mining documentation","url":"https://www.nexscope.ai/api-docs/ozon-keyword-mining"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.ozon-keyword-mining.","properties":{"keyword":{"type":"string","description":"Seed keyword, mining expands around this term (maxLength 1000)","example":"phone case"},"page":{"type":"object","description":"Pagination & sorting: {page, pageSize, orders[]}","example":{"page":1,"pageSize":10},"properties":{"page":{"type":"integer","description":"Page number, starting from 1, default 1","example":1},"pageSize":{"type":"integer","description":"Items per page, default 20","example":1},"orders":{"type":"array","items":{},"description":"Sort rules, elements {field, direction}; direction takes DESC (descending) / ASC (ascending)","example":[]}},"additionalProperties":true},"matchType":{"type":"integer","description":"Keyword match mode: 0 exact, 1 fuzzy","example":1},"includeKeywords":{"type":"array","items":{},"description":"Include keyword array (max 1000), used to further narrow down / specify required words on top of the seed term","example":[]},"excludeKeywords":{"type":"array","items":{},"description":"Exclude keyword array (max 1000), used to remove irrelevant terms","example":[]},"wordCount":{"type":"string","description":"Keyword word count range"},"searchVolume":{"type":"string","description":"Search volume range"},"searchChange30":{"type":"string","description":"30-day search change range"},"productViews":{"type":"string","description":"Product views range"},"products":{"type":"string","description":"Product count range"},"sellers":{"type":"string","description":"Seller count range"},"price":{"type":"string","description":"Price range"},"marketSpace":{"type":"string","description":"Market space range"},"conversionSharing":{"type":"string","description":"Conversion concentration range"},"relevancy":{"type":"string","description":"Relevance range (degree of relevance to the seed keyword)"},"uniqQueriesWCa":{"type":"string","description":"Add-to-cart count range"},"ca":{"type":"string","description":"Add-to-cart conversion rate range"},"titleDensity":{"type":"string","description":"Title density range"},"adRivalCount":{"type":"string","description":"Ad competitor count range"},"uId":{"type":"string","description":"User ID","example":"example-id"},"memberId":{"type":"string","description":"Member ID (a unique member identifier; data is attributed to memberId)","example":"example-id"}},"required":["keyword","page"],"example":{"uId":"example-id","page":{"page":1,"pageSize":10},"includeKeywords":[],"keyword":"phone case","excludeKeywords":[],"matchType":1},"additionalProperties":true},"example":{"uId":"example-id","page":{"page":1,"pageSize":10},"includeKeywords":[],"keyword":"phone case","excludeKeywords":[],"matchType":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total record count","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Keyword mining data (see details below)","example":[],"items":{"type":"object","properties":{"query":{"type":"string","description":"Keyword (original Russian)","example":"phone case"},"queryCn":{"type":"string","description":"Keyword Chinese translation","example":"phone case"},"platform":{"type":"integer","description":"Platform: 0 Ozon, 1 Wildberries","example":1},"searchVolume":{"type":"integer","description":"Monthly search volume","example":1},"count30GrowthRate":{"type":"number","description":"Monthly search growth (%, can be negative)","example":1},"productCount":{"type":"integer","description":"Product count (may be missing in some rows)","example":1},"competingProducts":{"type":"integer","description":"Competing product count","example":1},"sellers":{"type":"integer","description":"Seller count","example":1},"avgPrice":{"type":"number","description":"Average price","example":1},"itemsViews":{"type":"number","description":"Product visibility","example":1},"viewSharing":{"type":"number","description":"View concentration (%)","example":1},"conversionSharing":{"type":"number","description":"Conversion concentration (%)","example":1},"marketSpace":{"type":"number","description":"Market space","example":1},"returnCancellationRate":{"type":"number","description":"Return/cancellation rate (%)","example":1},"uniqQueriesWCa":{"type":"integer","description":"Add-to-cart count","example":1},"ca":{"type":"number","description":"Add-to-cart conversion rate (%)","example":1},"relevancy":{"type":"number","description":"Relevance (degree of relevance to the seed keyword)","example":1},"titleDensity":{"type":"number","description":"Title density","example":1},"wordCount":{"type":"integer","description":"Word count","example":1},"categories":{"type":"array","description":"Category ID array","example":[]},"categoryInfos":{"type":"array","description":"Category information (see below)","example":[],"items":{"type":"object","properties":{"titleCn":{"type":"string","description":"Category Chinese name","example":null},"titleEn":{"type":"string","description":"Category English name","example":null},"titleRu":{"type":"string","description":"Category Russian name","example":null},"cnTitlePath":{"type":"string","description":"Chinese category path","example":null},"enTitlePath":{"type":"string","description":"English category path","example":null},"titlePath":{"type":"string","description":"Russian category path","example":null},"id":{"type":"string","description":"Category ID","example":"example-id"},"crossBorderSellable":{"type":"boolean","description":"Whether cross-border sales are allowed","example":false}}}},"products":{"type":"array","description":"Top product data (see below)","example":[],"items":{"type":"object","properties":{"ozonId":{"type":"integer","description":"Ozon product ID","example":1},"sku":{"type":"integer","description":"SKU ID","example":1},"title":{"type":"string","description":"Product title (Russian)","example":null},"imageUrl":{"type":"string","description":"Main image URL","example":"https://example.com/image.jpg"},"advert":{"type":"integer","description":"Ad indicator (0/1)","example":1}}}},"id":{"type":"string","description":"Record ID","example":"example-id"}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions, elements contain {field, title, cellType, sortable, filterable}","example":[]},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"API latency (milliseconds)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Response display type, e.g., tableListWorkbenches","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"query":"phone case","queryCn":"phone case","platform":1,"searchVolume":1,"count30GrowthRate":1,"productCount":1,"competingProducts":1,"sellers":1,"avgPrice":1,"itemsViews":1,"viewSharing":1,"conversionSharing":1,"marketSpace":1,"returnCancellationRate":1,"uniqQueriesWCa":1,"ca":1,"relevancy":1,"titleDensity":1,"wordCount":1,"categories":[],"categoryInfos":[{"id":"example-id","crossBorderSellable":false}],"products":[{"ozonId":1,"sku":1,"imageUrl":"https://example.com/image.jpg","advert":1}],"id":"example-id"}],"columns":[],"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ozon-keyword-mining","x-nexscope-mcp-tool-name":"nexscope_ozon_keyword_mining","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ozon-market-keyword-search/run":{"post":{"tags":["Keyword & Search Demand"],"summary":"Ozon Market Keyword Search","description":"Nexscope Ozon market hot keyword search: filters Ozon (and Wildberries) market keywords by multi-dimensional metrics including search volume, growth, product count, seller count, competitor count, price, sales, conversion concentration, etc. Each keyword carries monthly search volume, growth, market space, competitor/seller counts, average price, cart-add conversion, top products, and market profile. Use for Ozon keyword selection, blue-ocean keyword mining, and market opportunity analysis. Trigger when the user mentions Ozon hot keywords, Ozon keyword market analysis, Ozon keyword selection, Ozon blue-ocean keywords, Ozon search volume, Wildberries keywords, Nexscope Ozon, Ozon market keyword search, Ozon keyword research, blue ocean keywords Ozon. Also trigger when the intent is to filter Ozon market keywords by metrics and view market profiles, even without explicitly mentioning Nexscope.","operationId":"runOzonMarketKeywordSearch","externalDocs":{"description":"Ozon Market Keyword Search documentation","url":"https://www.nexscope.ai/api-docs/ozon-market-keyword-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.ozon-market-keyword-search.","properties":{"page":{"type":"object","description":"Pagination & sorting: {page, pageSize, orders[]}","example":{"page":1,"pageSize":10},"properties":{"page":{"type":"integer","description":"Page number, starting from 1, default 1","example":1},"pageSize":{"type":"integer","description":"Items per page, default 20","example":1},"orders":{"type":"array","items":{},"description":"Sort rules, elements {field, direction}; direction takes DESC (descending) / ASC (ascending)","example":[]}},"additionalProperties":true},"keywords":{"type":"array","items":{"type":"string"},"description":"Keyword array (max 1000), used with matchType","example":[]},"matchType":{"type":"integer","description":"Keyword match mode: 0 exact, 1 fuzzy","example":1},"searchDate":{"type":"string","description":"Query date yyyy-MM-dd (e.g., 2026-04-01); defaults to last 30 days if omitted; passing 2026-04-01 queries March 2026 data","example":"2026-01-01"},"categories":{"type":"array","items":{},"description":"Category ID array (max 1000)","example":[]},"searchVolume":{"type":"object","description":"Search volume range {min,max}","example":{"min":1},"properties":{"min":{"type":"integer"}},"additionalProperties":true},"searchChange30":{"type":"object","description":"30-day search change range {min,max}","example":{"min":1},"properties":{"min":{"type":"integer"}},"additionalProperties":true},"monthlySales":{"type":"object","description":"Monthly sales range {min,max}","example":{"min":1},"properties":{"min":{"type":"integer"}},"additionalProperties":true},"monthlyRevenue":{"type":"object","description":"Monthly revenue range {min,max}","example":{"min":1},"properties":{"min":{"type":"integer"}},"additionalProperties":true},"price":{"type":"object","description":"Price range {min,max}","example":{"min":1},"properties":{"min":{"type":"integer"}},"additionalProperties":true},"productViews":{"type":"object","description":"Product views range {min,max}","example":{"min":1},"properties":{"min":{"type":"integer"}},"additionalProperties":true},"products":{"type":"object","description":"Product count range {min,max}","example":{"min":1},"properties":{"min":{"type":"integer"}},"additionalProperties":true},"volume":{"type":"object","description":"Volume range {min,max}","example":{"min":1},"properties":{"min":{"type":"integer"}},"additionalProperties":true},"marketSpace":{"type":"object","description":"Market space range {min,max}","example":{"min":1},"properties":{"min":{"type":"integer"}},"additionalProperties":true},"conversionSharing":{"type":"object","description":"Conversion concentration range {min,max}","example":{"min":1},"properties":{"min":{"type":"integer"}},"additionalProperties":true},"reviews":{"type":"object","description":"Review count range {min,max}","example":{"min":1},"properties":{"min":{"type":"integer"}},"additionalProperties":true},"ratings":{"type":"object","description":"Rating range {min,max}","example":{"min":1},"properties":{"min":{"type":"integer"}},"additionalProperties":true},"sellers":{"type":"object","description":"Seller count range {min,max}","example":{"min":1},"properties":{"min":{"type":"integer"}},"additionalProperties":true},"weight":{"type":"object","description":"Weight range {min,max}","example":{"min":1},"properties":{"min":{"type":"integer"}},"additionalProperties":true},"uId":{"type":"string","description":"User ID","example":"example-id"},"memberId":{"type":"string","description":"Member ID (a unique member identifier; data is attributed to memberId)","example":"example-id"}},"required":["page"],"example":{"searchDate":"2026-01-01","page":{"page":1,"pageSize":10},"keywords":["phone case"],"uId":"example-id","matchType":1,"categories":[]},"additionalProperties":true},"example":{"searchDate":"2026-01-01","page":{"page":1,"pageSize":10},"keywords":["phone case"],"uId":"example-id","matchType":1,"categories":[]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total record count","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Market hot keyword data (see details below)","example":[],"items":{"type":"object","properties":{"query":{"type":"string","description":"Keyword (original Russian)","example":"phone case"},"queryCn":{"type":"string","description":"Keyword Chinese translation","example":"phone case"},"platform":{"type":"integer","description":"Platform: 0 Ozon, 1 Wildberries","example":1},"searchVolume":{"type":"integer","description":"Monthly search volume","example":1},"count30GrowthRate":{"type":"number","description":"Monthly search growth (%, can be negative)","example":1},"productCount":{"type":"integer","description":"Product count (may be missing in some rows)","example":1},"competingProducts":{"type":"integer","description":"Competing product count","example":1},"sellers":{"type":"integer","description":"Seller count","example":1},"avgPrice":{"type":"number","description":"Average price","example":1},"itemsViews":{"type":"number","description":"Product visibility","example":1},"viewSharing":{"type":"number","description":"View concentration (%)","example":1},"conversionSharing":{"type":"number","description":"Conversion concentration (%)","example":1},"marketSpace":{"type":"integer","description":"Market space","example":1},"returnCancellationRate":{"type":"number","description":"Return/cancellation rate (%)","example":1},"uniqQueriesWCa":{"type":"integer","description":"Add-to-cart count","example":1},"ca":{"type":"number","description":"Add-to-cart conversion rate (%)","example":1},"categories":{"type":"array","description":"Category ID array","example":[]},"categoryInfos":{"type":"array","description":"Category information (see below)","example":[],"items":{"type":"object","properties":{"titleCn":{"type":"string","description":"Category Chinese name","example":null},"titleEn":{"type":"string","description":"Category English name","example":null},"titleRu":{"type":"string","description":"Category Russian name","example":null},"cnTitlePath":{"type":"string","description":"Chinese category path","example":null},"enTitlePath":{"type":"string","description":"English category path","example":null},"titlePath":{"type":"string","description":"Russian category path","example":null},"id":{"type":"string","description":"Category ID","example":"example-id"},"crossBorderSellable":{"type":"boolean","description":"Whether cross-border sales are allowed","example":false}}}},"products":{"type":"array","description":"Top product data (see below)","example":[],"items":{"type":"object","properties":{"ozonId":{"type":"integer","description":"Ozon product ID","example":1},"sku":{"type":"integer","description":"SKU ID","example":1},"title":{"type":"string","description":"Product title (Russian)","example":null},"imageUrl":{"type":"string","description":"Main image URL","example":"https://example.com/image.jpg"},"advert":{"type":"integer","description":"Ad indicator (0/1)","example":1}}}},"id":{"type":"string","description":"Record ID","example":"example-id"}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions, elements contain {field, title, cellType, sortable, filterable}","example":[]},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"API latency (milliseconds)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Response display type, e.g., tableListWorkbenches","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"query":"phone case","queryCn":"phone case","platform":1,"searchVolume":1,"count30GrowthRate":1,"productCount":1,"competingProducts":1,"sellers":1,"avgPrice":1,"itemsViews":1,"viewSharing":1,"conversionSharing":1,"marketSpace":1,"returnCancellationRate":1,"uniqQueriesWCa":1,"ca":1,"categories":[],"categoryInfos":[{"id":"example-id","crossBorderSellable":false}],"products":[{"ozonId":1,"sku":1,"imageUrl":"https://example.com/image.jpg","advert":1}],"id":"example-id"}],"columns":[],"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ozon-market-keyword-search","x-nexscope-mcp-tool-name":"nexscope_ozon_market_keyword_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ozon-product-detail/run":{"post":{"tags":["Ozon Marketplace"],"summary":"Ozon Product Detail","description":"Nexscope Ozon Russia SKU full detail query for one product ID per call, returning price, discount, Ozon Card price, rating, review count, stock, sales, revenue, revenue potential/lost revenue, listing date, images, and the complete product card.","operationId":"runOzonProductDetail","externalDocs":{"description":"Ozon Product Detail documentation","url":"https://www.nexscope.ai/api-docs/ozon-product-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"endDate":{"description":"Statistics end date, format YYYY-MM-DD; latest is yesterday","example":"2025-03-31","type":"string"},"includeFbs":{"description":"Whether to include FBS data for the requested SKU","example":false,"type":"boolean"},"productId":{"description":"One Ozon product SKU as an integer or string; arrays and productIds are not accepted","example":1786874757,"type":["integer","string"]},"startDate":{"description":"Statistics start date, format YYYY-MM-DD; latest is yesterday","example":"2025-03-01","type":"string"}},"required":["productId"],"type":"object"},"example":{"endDate":"2025-03-31","includeFbs":false,"productId":1786874757,"startDate":"2025-03-01"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of SKUs returned (= successCount + failedCount)","example":1},{"type":"null"}]},"successCount":{"anyOf":[{"type":"integer","description":"Number of SKUs for which cards were successfully returned","example":1},{"type":"null"}]},"failedCount":{"anyOf":[{"type":"integer","description":"Number of SKUs that failed","example":0},{"type":"null"}]},"failures":{"anyOf":[{"type":"array","description":"List of failed SKU details (each item contains the failed productId and error info)","example":[]},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product card list (see details below)","example":[],"items":{"type":"object","properties":{"productId":{"type":"integer","description":"SKU ID","example":1786874757},"title":{"type":"string","description":"Product name (Russian)","example":null},"brand":{"type":"string","description":"Brand","example":null},"sellerName":{"type":"string","description":"Seller name","example":null},"sellerId":{"type":"integer","description":"Seller ID","example":1},"sellerIsBestSeller":{"type":"boolean","description":"Whether the seller is a best seller","example":false},"nicheName":{"type":"string","description":"Niche path (Russian, / separated)","example":null},"nicheId":{"type":"integer","description":"Niche ID","example":1},"firstDate":{"type":"string","description":"Listing date (yyyy-MM-dd)","example":"2025-03-01"},"updated":{"type":"string","description":"Data update time (yyyy-MM-dd HH:mm:ss)","example":"2025-03-31 12:00:00"},"note":{"type":"string","description":"Notes","example":null},"sourceTool":{"type":"string","description":"Source tool identifier","example":null},"sourceType":{"type":"string","description":"Data source identifier","example":null},"imageUrl":{"type":"string","description":"Main image URL (first large image)","example":"https://example.com/image.jpg"},"imageCount":{"type":"integer","description":"Total image count","example":1},"productImageUrls":{"type":"array","description":"Remaining large image URLs besides the main image","example":[]},"productPageUrl":{"type":"string","description":"Product page URL","example":"https://example.com/image.jpg"},"price":{"type":"number","description":"Current selling price","example":1},"oldPrice":{"type":"number","description":"Original price before discount","example":1},"ozonCardPrice":{"type":"number","description":"Ozon Card price (bank card discount price)","example":1},"discount":{"type":"integer","description":"Discount, integer percentage 0-100","example":1},"currency":{"type":"string","description":"Currency symbol (₽ / $ / €)","example":null},"rating":{"type":"number","description":"Rating, 0-5","example":1},"reviewCount":{"type":"integer","description":"Number of reviews","example":1},"balance":{"type":"integer","description":"Current stock (units)","example":1},"deliveryScheme":{"type":"string","description":"Delivery scheme; FBO = Ozon fulfillment, FBS = seller self-delivery","example":null},"salesPerDay":{"type":"number","description":"Average daily sales (units/day)","example":1},"salesPerDayWithStock":{"type":"number","description":"Average daily sales counting only days with stock","example":1},"dailySalesRevenue":{"type":"number","description":"Average daily sales revenue","example":1},"dailySalesRevenueWithStock":{"type":"number","description":"Average daily sales revenue counting only days with stock","example":1},"monthlySalesUnits":{"type":"integer","description":"Sales volume during the statistics period (units)","example":1},"monthlySalesRevenue":{"type":"number","description":"Sales revenue during the statistics period","example":1},"previousSalesUnits":{"type":"integer","description":"Prior period sales volume (the same-length period before the current statistics period)","example":1},"previousRevenue":{"type":"number","description":"Prior period sales revenue","example":1},"revenuePotential":{"type":"number","description":"Potential revenue (estimated based on full-period stock availability)","example":1},"lostProfit":{"type":"number","description":"Lost revenue (due to stockouts, etc.)","example":1},"lostProfitPercent":{"type":"number","description":"Lost revenue percentage (%)","example":1}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered column definitions","example":[]},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"API latency (milliseconds)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Response type","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"successCount":1,"failedCount":0,"failures":[],"products":[{"productId":1786874757,"sellerId":1,"sellerIsBestSeller":false,"nicheId":1,"firstDate":"2025-03-01","updated":"2025-03-31 12:00:00","imageUrl":"https://example.com/image.jpg","imageCount":1,"productImageUrls":[],"productPageUrl":"https://example.com/image.jpg","price":1,"oldPrice":1,"ozonCardPrice":1,"discount":1,"rating":1,"reviewCount":1,"balance":1,"salesPerDay":1,"salesPerDayWithStock":1,"dailySalesRevenue":1,"dailySalesRevenueWithStock":1,"monthlySalesUnits":1,"monthlySalesRevenue":1,"previousSalesUnits":1,"previousRevenue":1,"revenuePotential":1,"lostProfit":1,"lostProfitPercent":1}],"columns":[],"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ozon-product-detail","x-nexscope-mcp-tool-name":"nexscope_ozon_product_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ozon-product-detail-search/run":{"post":{"tags":["Ozon Marketplace"],"summary":"Ozon Product Detail Search","description":"Nexscope Ozon product detail query: fetches the complete detail of a single Ozon product by SKU, returning title, price (RUB), rating, review count, QA count, total and daily average sales within the stats window, revenue, stock, category ranking, daily sales trend, brand, seller, fulfillment method (FBO/FBS/OZON), weight, and listing time/days/months. Use for single product deep analysis, competitor product teardown, Ozon product selection assessment, listing diagnosis, sales trend and category ranking tracking. Trigger when the user mentions Ozon product detail, Ozon single product analysis, Ozon SKU query, competitor product data, Ozon sales trend, Ozon category ranking, Ozon stock, Ozon listing time, Nexscope Ozon product search, Ozon product detail, Ozon SKU lookup, single product analysis, competitor product teardown, Ozon sales trend, category rank. Also trigger when the intent is to view detailed data of an Ozon product, even without explicitly mentioning Nexscope.","operationId":"runOzonProductDetailSearch","externalDocs":{"description":"Ozon Product Detail Search documentation","url":"https://www.nexscope.ai/api-docs/ozon-product-detail-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.ozon-product-detail-search.","properties":{"sku":{"type":"string","description":"Product SKU (Ozon SKU, e.g., 175924376). This is the sku returned by other Nexscope Ozon tools","example":"1664362124"},"dateRange":{"type":"string","description":"Sales/metrics statistics window, default past_30_days. Options: past_7_days / past_30_days / past_60_days / past_90_days / past_180_days / past_365_days","example":"past_30_days"},"uId":{"type":"string","description":"User ID (max 1000)","example":"example-id"},"memberId":{"type":"string","description":"Member ID (a unique member identifier; a user can belong to multiple teams; data is attributed to memberId, max 1000)","example":"example-id"}},"required":["sku"],"example":{"dateRange":"past_30_days","sku":"1664362124"},"additionalProperties":true},"example":{"dateRange":"past_30_days","sku":"1664362124"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records returned (1 on hit, 0 on miss)","example":1},{"type":"null"}]},"totalSales":{"anyOf":[{"type":"integer","description":"Total sales volume within the statistics window","example":1},{"type":"null"}]},"dailySales":{"anyOf":[{"type":"number","description":"Average daily sales (approx totalSales / window days)","example":1},{"type":"null"}]},"totalRevenue":{"anyOf":[{"type":"number","description":"Sales revenue within the statistics window (RUB)","example":1},{"type":"null"}]},"stock":{"anyOf":[{"type":"integer","description":"Stock","example":1},{"type":"null"}]},"startDate":{"anyOf":[{"type":"string","description":"Statistics window start date (e.g., 2026-06-01)","example":"2026-01-01"},{"type":"null"}]},"endDate":{"anyOf":[{"type":"string","description":"Statistics window end date (e.g., 2026-06-30)","example":"2026-01-01"},{"type":"null"}]},"salesTrendVOList":{"anyOf":[{"type":"array","description":"Daily sales data series (see below)","example":[],"items":{"type":"object","properties":{"date":{"type":"string","description":"Date (e.g., 2026-06-01)","example":"2026-01-01"},"sales":{"type":"integer","description":"Daily sales (may be 0)","example":1},"revenue":{"type":"number","description":"Daily revenue (RUB)","example":1},"price":{"type":"number","description":"Daily price (RUB)","example":1},"stock":{"type":"integer","description":"Daily stock","example":1},"reviewCount":{"type":"integer","description":"Cumulative review count as of this date","example":1},"reviewRating":{"type":"number","description":"Rating as of this date","example":1}}}},{"type":"null"}]},"categoryRanks":{"anyOf":[{"type":"array","description":"Product category ranking history (see below)","example":[],"items":{"type":"object","properties":{"date":{"type":"string","description":"Month (e.g., 2026-02; current month shows as specific date 2026-07-01)","example":"2026-01-01"},"rank":{"type":"integer","description":"Category ranking","example":1},"count":{"type":"integer","description":"Statistics count (subject to actual gateway interpretation)","example":1}}}},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product detail list (1 record on single SKU hit, empty on miss)","example":[],"items":{"type":"object","properties":{"sku":{"type":"integer","description":"Product SKU","example":1},"productId":{"type":"integer","description":"Unified product ID, mapped from sku","example":1},"title":{"type":"string","description":"Product title","example":null},"price":{"type":"number","description":"Product price (RUB)","example":1},"currency":{"type":"string","description":"Currency, always ₽","example":null},"reviewRating":{"type":"number","description":"Product rating","example":1},"rating":{"type":"number","description":"Unified rating, mapped from reviewRating","example":1},"reviewCount":{"type":"integer","description":"Number of reviews","example":1},"questionsAndAnswers":{"type":"integer","description":"QA count","example":1},"brandName":{"type":"string","description":"Brand name","example":null},"brand":{"type":"string","description":"Unified brand, mapped from brandName","example":null},"brandId":{"type":"integer","description":"Brand ID","example":1},"brandUrl":{"type":"string","description":"Brand link","example":"https://example.com/image.jpg"},"sellerName":{"type":"string","description":"Seller name","example":null},"sellerId":{"type":"integer","description":"Seller ID (negative values indicate Ozon platform self-operated sellers, e.g., -4 Ozon Россия)","example":1},"fulfillment":{"type":"array","description":"Product fulfillment methods, e.g., [\"FBO\"], [\"OZON\"], may contain multiple values","example":[]},"upTime":{"type":"integer","description":"Listing time, millisecond timestamp","example":1},"upDays":{"type":"integer","description":"Days since listing","example":1},"upMonths":{"type":"integer","description":"Months since listing","example":1},"imageUrl":{"type":"string","description":"Unified main image URL, mapped from the first of imageUrls","example":"https://example.com/image.jpg"},"imageUrls":{"type":"array","description":"List of product image URLs","example":[]},"productUrl":{"type":"string","description":"Product URL","example":"https://example.com/image.jpg"},"productPageUrl":{"type":"string","description":"Unified product page URL, mapped from productUrl","example":"https://example.com/image.jpg"},"categoryInfo":{"type":"object","description":"Product category information (see below)","example":{},"properties":{"cnTitlePath":{"type":"string","description":"Chinese category path","example":null},"enTitlePath":{"type":"string","description":"English category path","example":null},"titlePath":{"type":"string","description":"Category path (original text)","example":null},"category":{"type":"object","description":"Terminal category object (fields see below)","example":{},"properties":{"cnTitle":{"type":"string","description":"Category Chinese name","example":null},"enTitle":{"type":"string","description":"Category English name","example":null},"title":{"type":"string","description":"Category original title","example":null},"level":{"type":"integer","description":"Category level","example":1},"id":{"type":"string","description":"Category ID","example":"example-id"},"pid":{"type":"string","description":"Parent category ID","example":"example-id"},"crossBorderSellable":{"type":"boolean","description":"Whether cross-border sales are supported","example":false},"disabled":{"type":"boolean","description":"Whether disabled","example":false}}},"fullCategoryId":{"type":"array","description":"Full category ID path (string array, root to terminal, e.g., [\"99999999\", \"99999999_200001489\", \"99999999_200001489_970727001\"])","example":[]}}},"monthlySalesUnits":{"type":"integer","description":"Unified monthly sales, actual value equals totalSales of the current statistics window","example":1},"monthlySalesRevenue":{"type":"number","description":"Unified monthly revenue, actual value equals totalRevenue of the current statistics window","example":1},"sourceType":{"type":"string","description":"Data source, always ozon","example":null},"sourceTool":{"type":"string","description":"Source tool identifier for the Ozon competitor-detail endpoint","example":null},"weight":{"type":"number","description":"Product weight, in grams (digital/service products may not return this, see field differences)","example":1},"grossMargin":{"type":"number","description":"Gross margin (defined in schema, some products may not return this in practice, see field differences)","example":1}}}},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Returned data, content identical to products","example":[],"items":{"type":"object","properties":{"sku":{"type":"integer","description":"Product SKU","example":1},"productId":{"type":"integer","description":"Unified product ID, mapped from sku","example":1},"title":{"type":"string","description":"Product title","example":null},"price":{"type":"number","description":"Product price (RUB)","example":1},"currency":{"type":"string","description":"Currency, always ₽","example":null},"reviewRating":{"type":"number","description":"Product rating","example":1},"rating":{"type":"number","description":"Unified rating, mapped from reviewRating","example":1},"reviewCount":{"type":"integer","description":"Number of reviews","example":1},"questionsAndAnswers":{"type":"integer","description":"QA count","example":1},"brandName":{"type":"string","description":"Brand name","example":null},"brand":{"type":"string","description":"Unified brand, mapped from brandName","example":null},"brandId":{"type":"integer","description":"Brand ID","example":1},"brandUrl":{"type":"string","description":"Brand link","example":"https://example.com/image.jpg"},"sellerName":{"type":"string","description":"Seller name","example":null},"sellerId":{"type":"integer","description":"Seller ID (negative values indicate Ozon platform self-operated sellers, e.g., -4 Ozon Россия)","example":1},"fulfillment":{"type":"array","description":"Product fulfillment methods, e.g., [\"FBO\"], [\"OZON\"], may contain multiple values","example":[]},"upTime":{"type":"integer","description":"Listing time, millisecond timestamp","example":1},"upDays":{"type":"integer","description":"Days since listing","example":1},"upMonths":{"type":"integer","description":"Months since listing","example":1},"imageUrl":{"type":"string","description":"Unified main image URL, mapped from the first of imageUrls","example":"https://example.com/image.jpg"},"imageUrls":{"type":"array","description":"List of product image URLs","example":[]},"productUrl":{"type":"string","description":"Product URL","example":"https://example.com/image.jpg"},"productPageUrl":{"type":"string","description":"Unified product page URL, mapped from productUrl","example":"https://example.com/image.jpg"},"categoryInfo":{"type":"object","description":"Product category information (see below)","example":{},"properties":{"cnTitlePath":{"type":"string","description":"Chinese category path","example":null},"enTitlePath":{"type":"string","description":"English category path","example":null},"titlePath":{"type":"string","description":"Category path (original text)","example":null},"category":{"type":"object","description":"Terminal category object (fields see below)","example":{},"properties":{"cnTitle":{"type":"string","description":"Category Chinese name","example":null},"enTitle":{"type":"string","description":"Category English name","example":null},"title":{"type":"string","description":"Category original title","example":null},"level":{"type":"integer","description":"Category level","example":1},"id":{"type":"string","description":"Category ID","example":"example-id"},"pid":{"type":"string","description":"Parent category ID","example":"example-id"},"crossBorderSellable":{"type":"boolean","description":"Whether cross-border sales are supported","example":false},"disabled":{"type":"boolean","description":"Whether disabled","example":false}}},"fullCategoryId":{"type":"array","description":"Full category ID path (string array, root to terminal, e.g., [\"99999999\", \"99999999_200001489\", \"99999999_200001489_970727001\"])","example":[]}}},"monthlySalesUnits":{"type":"integer","description":"Unified monthly sales, actual value equals totalSales of the current statistics window","example":1},"monthlySalesRevenue":{"type":"number","description":"Unified monthly revenue, actual value equals totalRevenue of the current statistics window","example":1},"sourceType":{"type":"string","description":"Data source, always ozon","example":null},"sourceTool":{"type":"string","description":"Source tool identifier for the Ozon competitor-detail endpoint","example":null},"weight":{"type":"number","description":"Product weight, in grams (digital/service products may not return this, see field differences)","example":1},"grossMargin":{"type":"number","description":"Gross margin (defined in schema, some products may not return this in practice, see field differences)","example":1}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions, elements contain {field, title, cellType, sortable, filterable}","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Response display type, e.g., productWorkbenches","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"API latency (milliseconds)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"totalSales":1,"dailySales":1,"totalRevenue":1,"stock":1,"startDate":"2026-01-01","endDate":"2026-01-01","salesTrendVOList":[{"date":"2026-01-01","sales":1,"revenue":1,"price":1,"stock":1,"reviewCount":1,"reviewRating":1}],"categoryRanks":[{"date":"2026-01-01","rank":1,"count":1}],"products":[{"sku":1,"productId":1,"price":1,"reviewRating":1,"rating":1,"reviewCount":1,"questionsAndAnswers":1,"brandId":1,"brandUrl":"https://example.com/image.jpg","sellerId":1,"fulfillment":[],"upTime":1,"upDays":1,"upMonths":1,"imageUrl":"https://example.com/image.jpg","imageUrls":[],"productUrl":"https://example.com/image.jpg","productPageUrl":"https://example.com/image.jpg","categoryInfo":{"category":{"level":1,"id":"example-id","pid":"example-id","crossBorderSellable":false,"disabled":false},"fullCategoryId":[]},"monthlySalesUnits":1,"monthlySalesRevenue":1,"weight":1,"grossMargin":1}],"data":[{"sku":1,"productId":1,"price":1,"reviewRating":1,"rating":1,"reviewCount":1,"questionsAndAnswers":1,"brandId":1,"brandUrl":"https://example.com/image.jpg","sellerId":1,"fulfillment":[],"upTime":1,"upDays":1,"upMonths":1,"imageUrl":"https://example.com/image.jpg","imageUrls":[],"productUrl":"https://example.com/image.jpg","productPageUrl":"https://example.com/image.jpg","categoryInfo":{"category":{"level":1,"id":"example-id","pid":"example-id","crossBorderSellable":false,"disabled":false},"fullCategoryId":[]},"monthlySalesUnits":1,"monthlySalesRevenue":1,"weight":1,"grossMargin":1}],"columns":[],"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ozon-product-detail-search","x-nexscope-mcp-tool-name":"nexscope_ozon_product_detail_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ozon-product-report-search/run":{"post":{"tags":["Ozon Marketplace"],"summary":"Ozon Product Report Search","description":"Nexscope Ozon product report search: filters Ozon products by multi-dimensional metrics including sales, revenue, sales/revenue growth rate, cart conversion rate, order conversion rate, price, rating, review count, QA count, variant count, page views, gross margin, return/cancellation rate, ad spend share, weight/volume, listing time, brand, seller, fulfillment method, and labels. Returns each product's SKU, title, price (RUB), sales, revenue, lost revenue, conversion rate, rating, reviews, brand, seller, fulfillment method, listing days/months, and complete product report fields. Use for Ozon product selection, competitor product analysis, best-seller mining, price/conversion band filtering. Trigger when the user mentions Ozon product report, Ozon product selection, Ozon product filtering, Ozon product analysis, Ozon best-selling products, Ozon competitor product analysis, Ozon product report, Ozon product screener, filter Ozon products by sales, Ozon best-seller mining, Nexscope Ozon product report. Also trigger when the intent is to filter Ozon products by multiple metrics and view product-level reports, even without explicitly mentioning Nexscope.","operationId":"runOzonProductReportSearch","externalDocs":{"description":"Ozon Product Report Search documentation","url":"https://www.nexscope.ai/api-docs/ozon-product-report-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"object","description":"Nonempty pagination and sorting object: {page, pageSize, orders[]}. Omitted nested defaults are not inserted. Ranges accept optional finite bounds and require min <= max; numeric strings and optional null remain backend compatibility extensions.","example":{"page":1,"pageSize":10}},"page.page":{"type":"integer","description":"Page number, starting from 1, default 1","example":1},"page.pageSize":{"type":"integer","description":"Items per page, default 20","example":20},"page.orders":{"type":"array","description":"Sort rules, elements {field, direction}; direction takes DESC (descending) / ASC (ascending). field is a metric field in the response (e.g., sales, revenue, price, reviewRating, reviewCount, salesRate)","example":[{"direction":"DESC","field":"sales"}]},"skus":{"type":"array","description":"SKU array (max 10), for precise lookup of specified products","example":["1664362124"]},"keywords":{"type":"array","description":"Keyword array, filters by product title","example":[]},"categoryIds":{"type":"array","description":"Category ID array (Nexscope category IDs, not category names)","example":[]},"sellerName":{"type":"array","description":"Seller name array","example":[]},"brand":{"type":"object","description":"Brand filter: {brandName: array<string>, type: integer}; type takes 0 include brand, 1 exclude brand, 2 unbranded","example":{}},"fulfillment":{"type":"array","description":"Fulfillment method array, fixed options: OZON, FBO, FBS, RFBS, FBP","example":[]},"labels":{"type":"array","description":"Label array, fixed options: 0 new product, 1 genuine product, 2 best seller","example":[2]},"creationDate":{"type":"integer","description":"Listing time filter (months), fixed options: 1 last 30 days, 3 last 90 days, 6 last 180 days, 12 last year, 24 last two years; no filtering if omitted","example":1},"variationsMerge":{"type":"integer","description":"Whether to merge variants: 0 do not merge, 1 merge","example":1},"searchDate":{"type":"string","description":"Query date yyyy-MM-dd (e.g., 2026-04-01); defaults to last 30 days if omitted; passing 2026-04-01 queries March 2026 data","example":"2026-01-01"},"tag":{"type":"string","description":"Tag word","example":null},"uId":{"type":"string","description":"User ID","example":"example-id"},"memberId":{"type":"string","description":"Member ID (a unique member identifier; data is attributed to memberId)","example":"example-id"},"monthlySales":{"type":"object","description":"Monthly sales range: {min, max}; either bound may be omitted","example":{"min":5000}},"monthlySalesRate":{"type":"object","description":"Sales growth-rate range: {min, max}; either bound may be omitted","example":{"min":10}},"monthlyRevenue":{"type":"object","description":"Monthly revenue range in RUB: {min, max}; either bound may be omitted","example":{"min":100000}},"price":{"type":"object","description":"Price range in RUB: {min, max}; either bound may be omitted","example":{"max":500}},"convToCartPdp":{"type":"object","description":"Cart conversion-rate range: {min, max}; either bound may be omitted","example":{"min":20}},"reviewRating":{"type":"object","description":"Rating range from 0 to 5: {min, max}; either bound may be omitted","example":{"min":4}},"reviewCount":{"type":"object","description":"Review-count range: {min, max}; either bound may be omitted","example":{"min":100}},"questionsAndAnswers":{"type":"object","description":"Question-and-answer count range: {min, max}; either bound may be omitted","example":{"min":1}},"variants":{"type":"object","description":"Variant-count range: {min, max}; either bound may be omitted","example":{"min":1}},"drr":{"type":"object","description":"Advertising cost-share range: {min, max}; either bound may be omitted","example":{"max":20}},"grossMargin":{"type":"object","description":"Gross-margin range: {min, max}; either bound may be omitted","example":{"min":10}},"returnCancellationRate":{"type":"object","description":"Return and cancellation-rate range: {min, max}; either bound may be omitted","example":{"max":10}},"weight":{"type":"object","description":"Weight range in grams: {min, max}; either bound may be omitted","example":{"max":1000}},"volume":{"type":"object","description":"Volume range in liters: {min, max}; either bound may be omitted","example":{"max":10}}},"required":["page"],"additionalProperties":true},"example":{"page":{"page":1,"pageSize":10},"skus":["1664362124"]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total matched record count (can reach tens of millions with no filters; equals hit count when using skus precise lookup)","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Product report data (see details below), content identical to products","example":[],"items":{"type":"object","properties":{"sku":{"type":"integer","description":"Product SKU","example":1},"productId":{"type":"integer","description":"Unified product ID (= sku)","example":1},"title":{"type":"string","description":"Product title (original Russian)","example":null},"imageUrl":{"type":"string","description":"Product main image URL","example":"https://example.com/image.jpg"},"productUrl":{"type":"string","description":"Product URL","example":"https://example.com/image.jpg"},"productPageUrl":{"type":"string","description":"Unified product page URL (= productUrl)","example":"https://example.com/image.jpg"},"currency":{"type":"string","description":"Currency, always ₽","example":null},"sourceType":{"type":"string","description":"Data source, always ozon","example":null},"sourceTool":{"type":"string","description":"Source tool identifier for the Ozon bestseller report endpoint","example":null},"sales":{"type":"integer","description":"Monthly sales volume","example":1},"monthlySalesUnits":{"type":"integer","description":"Unified monthly sales (= sales)","example":1},"revenue":{"type":"number","description":"Monthly sales revenue (RUB)","example":1},"monthlySalesRevenue":{"type":"number","description":"Unified monthly revenue (= revenue)","example":1},"missedRevenue":{"type":"number","description":"Lost revenue (RUB)","example":1},"price":{"type":"number","description":"Price (RUB)","example":1},"convToCartPdp":{"type":"number","description":"Cart conversion rate (%)","example":1},"orderConversionRate":{"type":"number","description":"Order conversion rate (%)","example":1},"salesRate":{"type":"number","description":"Sales growth rate (%)","example":1},"revenueRate":{"type":"number","description":"Revenue growth rate (%)","example":1},"drr":{"type":"number","description":"Ad cost share (ratio)","example":1},"grossMargin":{"type":"number","description":"Gross margin (%)","example":1},"returnCancellationRate":{"type":"number","description":"Return/cancellation rate (%)","example":1},"views":{"type":"integer","description":"Product Card Views for the searchDate period: rolling last 30 days when omitted, or the selected complete historical month. Each request retrieves the latest available Nexscope data without caching the business response. This is a periodically updated statistic, not a strictly real-time count; its refresh frequency and delay SLA are unspecified.","example":1},"reviewRating":{"type":"number","description":"Rating (0~5)","example":1},"rating":{"type":"number","description":"Unified rating (= reviewRating)","example":1},"reviewCount":{"type":"integer","description":"Review count","example":1},"questionsAndAnswers":{"type":"integer","description":"QA count","example":1},"variants":{"type":"integer","description":"Variant count","example":1},"fulfillment":{"type":"array","description":"Fulfillment methods (values OZON/FBO/FBS/RFBS/FBP)","example":[]},"weight":{"type":"number","description":"Weight in g; the supplier does not specify whether this is packed shipping gross weight","example":1},"volume":{"type":"number","description":"Volume in L; the supplier does not specify whether this is item or external parcel volume or how it is measured","example":1},"upTime":{"type":"integer","description":"Listing timestamp (milliseconds)","example":1},"upDays":{"type":"integer","description":"Days since listing","example":1},"upMonths":{"type":"integer","description":"Months since listing","example":1},"brandName":{"type":"string","description":"Brand name","example":null},"brand":{"type":"string","description":"Unified brand (= brandName)","example":null},"brandId":{"type":"integer","description":"Brand ID","example":1},"brandUrl":{"type":"string","description":"Brand link","example":"https://example.com/image.jpg"},"sellerName":{"type":"string","description":"Seller name","example":null},"sellerId":{"type":"integer","description":"Seller ID (may be negative for Ozon self-operated)","example":1},"categoryInfo":{"type":"object","description":"Category information (see below)","example":{},"properties":{"cnTitlePath":{"type":"string","description":"Chinese category path","example":null},"enTitlePath":{"type":"string","description":"English category path","example":null},"titlePath":{"type":"string","description":"Russian category path","example":null},"fullCategoryId":{"type":"array","description":"Full category ID hierarchy array","example":[]},"category":{"type":"object","description":"Category node: {cnTitle, enTitle, title, level, id, pid, crossBorderSellable, disabled}","example":{}}}}}}},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product report data (identical to data, two keys for the same data)","example":[],"items":{"type":"object","properties":{"sku":{"type":"integer","description":"Product SKU","example":1},"productId":{"type":"integer","description":"Unified product ID (= sku)","example":1},"title":{"type":"string","description":"Product title (original Russian)","example":null},"imageUrl":{"type":"string","description":"Product main image URL","example":"https://example.com/image.jpg"},"productUrl":{"type":"string","description":"Product URL","example":"https://example.com/image.jpg"},"productPageUrl":{"type":"string","description":"Unified product page URL (= productUrl)","example":"https://example.com/image.jpg"},"currency":{"type":"string","description":"Currency, always ₽","example":null},"sourceType":{"type":"string","description":"Data source, always ozon","example":null},"sourceTool":{"type":"string","description":"Source tool identifier for the Ozon bestseller report endpoint","example":null},"sales":{"type":"integer","description":"Monthly sales volume","example":1},"monthlySalesUnits":{"type":"integer","description":"Unified monthly sales (= sales)","example":1},"revenue":{"type":"number","description":"Monthly sales revenue (RUB)","example":1},"monthlySalesRevenue":{"type":"number","description":"Unified monthly revenue (= revenue)","example":1},"missedRevenue":{"type":"number","description":"Lost revenue (RUB)","example":1},"price":{"type":"number","description":"Price (RUB)","example":1},"convToCartPdp":{"type":"number","description":"Cart conversion rate (%)","example":1},"orderConversionRate":{"type":"number","description":"Order conversion rate (%)","example":1},"salesRate":{"type":"number","description":"Sales growth rate (%)","example":1},"revenueRate":{"type":"number","description":"Revenue growth rate (%)","example":1},"drr":{"type":"number","description":"Ad cost share (ratio)","example":1},"grossMargin":{"type":"number","description":"Gross margin (%)","example":1},"returnCancellationRate":{"type":"number","description":"Return/cancellation rate (%)","example":1},"views":{"type":"integer","description":"Product Card Views for the searchDate period: rolling last 30 days when omitted, or the selected complete historical month. Each request retrieves the latest available Nexscope data without caching the business response. This is a periodically updated statistic, not a strictly real-time count; its refresh frequency and delay SLA are unspecified.","example":1},"reviewRating":{"type":"number","description":"Rating (0~5)","example":1},"rating":{"type":"number","description":"Unified rating (= reviewRating)","example":1},"reviewCount":{"type":"integer","description":"Review count","example":1},"questionsAndAnswers":{"type":"integer","description":"QA count","example":1},"variants":{"type":"integer","description":"Variant count","example":1},"fulfillment":{"type":"array","description":"Fulfillment methods (values OZON/FBO/FBS/RFBS/FBP)","example":[]},"weight":{"type":"number","description":"Weight in g; the supplier does not specify whether this is packed shipping gross weight","example":1},"volume":{"type":"number","description":"Volume in L; the supplier does not specify whether this is item or external parcel volume or how it is measured","example":1},"upTime":{"type":"integer","description":"Listing timestamp (milliseconds)","example":1},"upDays":{"type":"integer","description":"Days since listing","example":1},"upMonths":{"type":"integer","description":"Months since listing","example":1},"brandName":{"type":"string","description":"Brand name","example":null},"brand":{"type":"string","description":"Unified brand (= brandName)","example":null},"brandId":{"type":"integer","description":"Brand ID","example":1},"brandUrl":{"type":"string","description":"Brand link","example":"https://example.com/image.jpg"},"sellerName":{"type":"string","description":"Seller name","example":null},"sellerId":{"type":"integer","description":"Seller ID (may be negative for Ozon self-operated)","example":1},"categoryInfo":{"type":"object","description":"Category information (see below)","example":{},"properties":{"cnTitlePath":{"type":"string","description":"Chinese category path","example":null},"enTitlePath":{"type":"string","description":"English category path","example":null},"titlePath":{"type":"string","description":"Russian category path","example":null},"fullCategoryId":{"type":"array","description":"Full category ID hierarchy array","example":[]},"category":{"type":"object","description":"Category node: {cnTitle, enTitle, title, level, id, pid, crossBorderSellable, disabled}","example":{}}}}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions, elements contain {field, title, cellType, sortable, filterable}, identifying sortable/filterable fields","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Response display type, e.g., productWorkbenches","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"API latency (milliseconds)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"sku":1,"productId":1,"imageUrl":"https://example.com/image.jpg","productUrl":"https://example.com/image.jpg","productPageUrl":"https://example.com/image.jpg","sales":1,"monthlySalesUnits":1,"revenue":1,"monthlySalesRevenue":1,"missedRevenue":1,"price":1,"convToCartPdp":1,"orderConversionRate":1,"salesRate":1,"revenueRate":1,"drr":1,"grossMargin":1,"returnCancellationRate":1,"views":1,"reviewRating":1,"rating":1,"reviewCount":1,"questionsAndAnswers":1,"variants":1,"fulfillment":[],"weight":1,"volume":1,"upTime":1,"upDays":1,"upMonths":1,"brandId":1,"brandUrl":"https://example.com/image.jpg","sellerId":1,"categoryInfo":{"fullCategoryId":[],"category":{}}}],"products":[{"sku":1,"productId":1,"imageUrl":"https://example.com/image.jpg","productUrl":"https://example.com/image.jpg","productPageUrl":"https://example.com/image.jpg","sales":1,"monthlySalesUnits":1,"revenue":1,"monthlySalesRevenue":1,"missedRevenue":1,"price":1,"convToCartPdp":1,"orderConversionRate":1,"salesRate":1,"revenueRate":1,"drr":1,"grossMargin":1,"returnCancellationRate":1,"views":1,"reviewRating":1,"rating":1,"reviewCount":1,"questionsAndAnswers":1,"variants":1,"fulfillment":[],"weight":1,"volume":1,"upTime":1,"upDays":1,"upMonths":1,"brandId":1,"brandUrl":"https://example.com/image.jpg","sellerId":1,"categoryInfo":{"fullCategoryId":[],"category":{}}}],"columns":[],"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ozon-product-report-search","x-nexscope-mcp-tool-name":"nexscope_ozon_product_report_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ozon-product-search/run":{"post":{"tags":["Ozon Marketplace"],"summary":"Ozon Product Search","description":"Nexscope Ozon Russia product search and reverse lookup. Searches Ozon products in the Nexscope database by Russian keyword or SKU, returning product ID, title, brand, and seller information. The entry point for Ozon product discovery and competitor analysis chains. Trigger when the user mentions Ozon product selection, Ozon product search, Russian e-commerce product selection, Ozon keyword search, Ozon SKU query, Nexscope Ozon, Ozon product search, Nexscope Ozon, Russian marketplace, Ozon SKU lookup, Ozon keyword search. Also trigger when the intent is to discover or reverse-lookup products on Ozon Russia by keyword or SKU, even without explicitly mentioning Nexscope.","operationId":"runOzonProductSearch","externalDocs":{"description":"Ozon Product Search documentation","url":"https://www.nexscope.ai/api-docs/ozon-product-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.ozon-product-search.","properties":{"keyword":{"type":"string","description":"Russian search keyword, e.g., кроссовки (running shoes)","example":"phone case"},"productIds":{"type":"array","items":{},"description":"List of Ozon product SKUs (integer or string)","example":[]},"startDate":{"type":"string","description":"Statistics start date, format YYYY-MM-DD; defaults to one year ago if empty; latest is yesterday","example":"2026-01-01"},"endDate":{"type":"string","description":"Statistics end date, format YYYY-MM-DD; defaults to yesterday if empty; latest is yesterday","example":"2026-01-01"}},"example":{"endDate":"2026-01-31","startDate":"2026-01-01","keyword":"phone case"},"additionalProperties":true},"example":{"endDate":"2026-01-31","startDate":"2026-01-01","keyword":"phone case"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total matched count","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list (see details below)","example":[],"items":{"type":"object","properties":{"productId":{"type":"integer","description":"SKU ID","example":1},"title":{"type":"string","description":"Product name (Russian)","example":null},"productPageUrl":{"type":"string","description":"Product page URL","example":"https://example.com/image.jpg"},"imageUrl":{"type":"string","description":"Main image URL","example":"https://example.com/image.jpg"},"brand":{"type":"string","description":"Brand name","example":null},"brandId":{"type":"integer","description":"Brand ID","example":1},"sellerName":{"type":"string","description":"Seller name","example":null},"sellerId":{"type":"integer","description":"Seller ID","example":1},"sourceType":{"type":"string","description":"Data source identifier, always ozon","example":null},"sourceTool":{"type":"string","description":"Source tool identifier for the Ozon product-search endpoint","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered column definitions","example":[]},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"API latency (milliseconds)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Response type","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"productId":1,"productPageUrl":"https://example.com/image.jpg","imageUrl":"https://example.com/image.jpg","brandId":1,"sellerId":1}],"columns":[],"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ozon-product-search","x-nexscope-mcp-tool-name":"nexscope_ozon_product_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ozon-product-trend/run":{"post":{"tags":["Ozon Marketplace"],"summary":"Ozon Product Trend","description":"Nexscope Ozon Russia single SKU daily time-series performance. Returns daily sales units, price, stock, rating, and optionally search position/visibility data for one Ozon product by date granularity. Use for validating growth trends, seasonality, and anomaly detection. Trigger when the user mentions Ozon trend, Ozon sales trend, Ozon price trend, Ozon daily data, Ozon stock trend, Ozon search ranking, Ozon product history, Nexscope trend, Ozon daily performance, Ozon time series, Ozon search visibility, Russian marketplace product history. Also trigger when the intent is to view the daily/period trend of an Ozon product, even without explicitly mentioning Nexscope.","operationId":"runOzonProductTrend","externalDocs":{"description":"Ozon Product Trend documentation","url":"https://www.nexscope.ai/api-docs/ozon-product-trend"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.ozon-product-trend.","properties":{"productId":{"type":"integer","description":"Ozon product SKU","example":1664362124},"startDate":{"type":"string","description":"Statistics start date, YYYY-MM-DD; data delayed by T-1, latest is yesterday","example":"2026-01-01"},"endDate":{"type":"string","description":"Statistics end date, YYYY-MM-DD; data delayed by T-1, latest is yesterday","example":"2026-01-01"},"includeFbs":{"type":"boolean","description":"Whether to include FBS data","example":false},"includeSearchStats":{"type":"boolean","description":"Whether to include search position / visibility; not supported for some niches","example":false}},"required":["productId"],"example":{"includeSearchStats":false,"includeFbs":false,"startDate":"2026-01-01","productId":1664362124,"endDate":"2026-01-31"},"additionalProperties":true},"example":{"includeSearchStats":false,"includeFbs":false,"startDate":"2026-01-01","productId":1664362124,"endDate":"2026-01-31"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of daily data points (window days)","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"List of daily data points (see details below)","example":[],"items":{"type":"object","properties":{"date":{"type":"string","description":"Date, YYYY-MM-DD","example":"2026-01-01"},"hasData":{"type":"boolean","description":"Whether there is data for this day (false indicates a missing day, distinct from sales=0)","example":false},"price":{"type":"number","description":"Daily selling price","example":1},"oldPrice":{"type":"number","description":"Daily original price before discount","example":1},"ozonCardPrice":{"type":"number","description":"Ozon Card price (Ozon official bank card discount price)","example":1},"discount":{"type":"integer","description":"Discount, integer percentage 0-100","example":1},"currency":{"type":"string","description":"Currency symbol (e.g., ₽ / $ / €)","example":null},"sales":{"type":"integer","description":"Daily sales (units)","example":1},"balance":{"type":"integer","description":"Daily FBO warehouse stock (units)","example":1},"rating":{"type":"number","description":"Rating, 0-5","example":1},"comments":{"type":"integer","description":"Review count","example":1},"isBestseller":{"type":"boolean","description":"Whether the \"bestseller\" badge was active that day","example":false},"isNew":{"type":"boolean","description":"Whether the \"new product\" badge was active that day","example":false}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered column definitions","example":[]},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"API latency (milliseconds)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Response type","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"date":"2026-01-01","hasData":false,"price":1,"oldPrice":1,"ozonCardPrice":1,"discount":1,"sales":1,"balance":1,"rating":1,"comments":1,"isBestseller":false,"isNew":false}],"columns":[],"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ozon-product-trend","x-nexscope-mcp-tool-name":"nexscope_ozon_product_trend","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ozon-seller-products/run":{"post":{"tags":["Ozon Marketplace"],"summary":"Ozon Seller Products","description":"Nexscope Ozon Russia seller drill-down product list by seller ID. Returns all SKUs under a seller with complete metrics: sales, revenue, price, rating, stock, turnover, lost revenue, supporting multi-dimensional numeric filters, sorting, and currency conversion. Use for store structure analysis, seller bestseller analysis, competitor store benchmarking. Trigger when the user mentions Ozon seller products, Ozon store analysis, Ozon seller drill-down, Ozon seller SKUs, Ozon store bestsellers, Ozon competitor store, Nexscope seller, Ozon seller drill-down, Ozon shop audit, Russian marketplace seller SKUs, Ozon store structure. Also trigger when the intent is to view all products and their sales performance under an Ozon seller ID, even without explicitly mentioning Nexscope.","operationId":"runOzonSellerProducts","externalDocs":{"description":"Ozon Seller Products documentation","url":"https://www.nexscope.ai/api-docs/ozon-seller-products"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.ozon-seller-products.","properties":{"sellerId":{"type":"string","description":"Ozon seller ID (numeric string), matching the seller identifier in product lists/seller rankings","example":"1581151"},"startDate":{"type":"string","description":"Statistics start date YYYY-MM-DD; latest is yesterday","example":"2026-01-01"},"endDate":{"type":"string","description":"Statistics end date YYYY-MM-DD; latest is yesterday","example":"2026-01-01"},"page":{"type":"integer","description":"Page number, starting from 1","example":1},"pageSize":{"type":"integer","description":"Rows per page 1-100, default 100","example":10},"sortField":{"type":"string","description":"Sort column name (snake_case), e.g., sales, revenue, final_price, balance, rating"},"sortDirection":{"type":"string","description":"asc / desc"},"currency":{"type":"string","description":"Currency code, default RUB, e.g., USD"},"currencyRate":{"type":"integer","description":"Custom exchange rate (for non-default currency)","example":1},"includeFbs":{"type":"boolean","description":"Whether to include FBS data","example":false},"filters":{"type":"array","items":{},"description":"List of numeric filter conditions, each {field, op, value, value2?}, multiple conditions AND","example":[]}},"required":["sellerId"],"example":{"page":1,"pageSize":10,"endDate":"2026-01-31","startDate":"2026-01-01","sellerId":"1581151","currencyRate":1},"additionalProperties":true},"example":{"page":1,"pageSize":10,"endDate":"2026-01-31","startDate":"2026-01-01","sellerId":"1581151","currencyRate":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total number of matched products under the seller","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list (see details below)","example":[],"items":{"type":"object","properties":{"productId":{"type":"integer","description":"SKU ID","example":1},"title":{"type":"string","description":"Product name (Russian)","example":null},"brand":{"type":"string","description":"Brand","example":null},"brandId":{"type":"integer","description":"Brand ID","example":1},"sellerName":{"type":"string","description":"Seller name","example":null},"sellerId":{"type":"integer","description":"Seller ID","example":1},"category":{"type":"string","description":"Category path (Russian, / separated)","example":null},"nicheName":{"type":"string","description":"Niche path (Russian)","example":null},"nicheId":{"type":"integer","description":"Niche ID","example":1},"country":{"type":"string","description":"Country of sale, always RU for Ozon","example":null},"firstDate":{"type":"string","description":"Listing date (yyyy-MM-dd)","example":"2026-01-01"},"imageUrl":{"type":"string","description":"Main image URL","example":"https://example.com/image.jpg"},"productPageUrl":{"type":"string","description":"Product page URL","example":"https://example.com/image.jpg"},"sourceTool":{"type":"string","description":"Source tool identifier","example":null},"sourceType":{"type":"string","description":"Data source identifier","example":null},"price":{"type":"number","description":"Current selling price","example":1},"oldPrice":{"type":"number","description":"Original price before discount","example":1},"ozonCardPrice":{"type":"number","description":"Ozon Card price","example":1},"minPrice":{"type":"number","description":"Minimum price during the statistics period","example":1},"maxPrice":{"type":"number","description":"Maximum price during the statistics period","example":1},"averagePrice":{"type":"number","description":"Average price during the statistics period","example":1},"currency":{"type":"string","description":"Currency symbol (₽ / $ / €)","example":null},"rating":{"type":"number","description":"Rating, 0-5","example":1},"reviewCount":{"type":"integer","description":"Number of reviews","example":1},"balance":{"type":"integer","description":"Current stock (units)","example":1},"balanceFbs":{"type":"integer","description":"FBS stock (seller self-ship units)","example":1},"frozenStocks":{"type":"integer","description":"Slow-moving stock","example":1},"warehousesCount":{"type":"integer","description":"Number of FBO warehouses","example":1},"isFbs":{"type":"boolean","description":"Whether shipped via FBS","example":false},"salesPerDay":{"type":"number","description":"Average daily sales (units/day)","example":1},"monthlySalesUnits":{"type":"integer","description":"Sales volume during the statistics period (units)","example":1},"monthlySalesRevenue":{"type":"number","description":"Sales revenue during the statistics period","example":1},"lostProfit":{"type":"number","description":"Lost revenue (due to stockouts, etc.)","example":1},"daysInSite":{"type":"integer","description":"Days on sale (statistics period, including out-of-stock days)","example":1},"daysInStock":{"type":"integer","description":"Days in stock","example":1},"turnoverDays":{"type":"number","description":"Turnover days (lower is faster)","example":1},"position":{"type":"integer","description":"Ranking within the current query dimension (seller for this endpoint)","example":1},"categoryPosition":{"type":"integer","description":"Ranking within the category","example":1},"revenueSharePercent":{"type":"number","description":"Revenue share of this SKU within the current query dimension, 0-100","example":1}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered column definitions","example":[]},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"API latency (milliseconds)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Response type","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"productId":1,"brandId":1,"sellerId":1,"nicheId":1,"firstDate":"2026-01-01","imageUrl":"https://example.com/image.jpg","productPageUrl":"https://example.com/image.jpg","price":1,"oldPrice":1,"ozonCardPrice":1,"minPrice":1,"maxPrice":1,"averagePrice":1,"rating":1,"reviewCount":1,"balance":1,"balanceFbs":1,"frozenStocks":1,"warehousesCount":1,"isFbs":false,"salesPerDay":1,"monthlySalesUnits":1,"monthlySalesRevenue":1,"lostProfit":1,"daysInSite":1,"daysInStock":1,"turnoverDays":1,"position":1,"categoryPosition":1,"revenueSharePercent":1}],"columns":[],"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ozon-seller-products","x-nexscope-mcp-tool-name":"nexscope_ozon_seller_products","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ozon-shop-search/run":{"post":{"tags":["Ozon Marketplace"],"summary":"Ozon Shop Search","description":"Nexscope Ozon shop product search: fetches the product list of an Ozon shop (seller) by shop ID, returning each product's 30-day sales, price, rating, weight, fulfillment method (FBO/FBS), seller type (local/cross-border), return/cancellation rate, and the shop's total 30-day sales. Use for competitor shop product analysis, shop bestseller mining, seller product structure analysis. Trigger when the user mentions Ozon shop products, Ozon seller product list, competitor shop analysis, Ozon shop bestsellers, Ozon seller analysis, Nexscope Ozon shop search, Ozon shop search, Ozon seller products, competitor shop analysis, Ozon store products. Also trigger when the intent is to view an Ozon shop/seller's products and sales data, even without explicitly mentioning Nexscope.","operationId":"runOzonShopSearch","externalDocs":{"description":"Ozon Shop Search documentation","url":"https://www.nexscope.ai/api-docs/ozon-shop-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.ozon-shop-search.","properties":{"id":{"type":"integer","description":"Shop (seller) ID, i.e., the sellerId returned by other Nexscope Ozon tools; negative values are Ozon platform self-operated sellers (e.g., -2 Ozon Express, -4 Ozon Fresh), positive values are third-party sellers","example":1581151},"page":{"type":"object","description":"Pagination & sorting: {page, pageSize, orders[]}","example":{"page":1,"pageSize":10},"properties":{"page":{"type":"integer","description":"Page number, starting from 1, default 1","example":1},"pageSize":{"type":"integer","description":"Items per page, default 20, maximum 20 (exceeding returns errcode 1002)","example":1},"orders":{"type":"array","items":{},"description":"Sort rules, elements {field, direction}; direction takes DESC (descending) / ASC (ascending). Common sort fields: sales, price, reviewRating, upTime","example":[]}},"additionalProperties":true},"uId":{"type":"string","description":"User ID (max 1000)","example":"example-id"},"memberId":{"type":"string","description":"Member ID (a unique member identifier; a user can belong to multiple teams; data is attributed to memberId, max 1000)","example":"example-id"}},"required":["id","page"],"example":{"id":1581151,"page":{"page":1,"pageSize":10}},"additionalProperties":true},"example":{"id":1581151,"page":{"page":1,"pageSize":10}}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records returned on this page (equals the current page data count, not total shop product count)","example":1},{"type":"null"}]},"totalSales":{"anyOf":[{"type":"integer","description":"Total shop sales in the last 30 days","example":1},{"type":"null"}]},"totalRevenue":{"anyOf":[{"type":"integer","description":"Total shop revenue in RUB","example":1},{"type":"null"}]},"dailySales":{"anyOf":[{"type":"integer","description":"Average daily shop sales","example":1},{"type":"null"}]},"rating":{"anyOf":[{"type":"number","description":"Shop rating, 0-5","example":1},{"type":"null"}]},"productCount":{"anyOf":[{"type":"integer","description":"Total products in the shop","example":1},{"type":"null"}]},"fulfillment":{"anyOf":[{"type":"object","description":"Shop fulfillment distribution by FBO/FBS product count","example":{}},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Shop product list (see details below)","example":[],"items":{"type":"object","properties":{"productId":{"type":"integer","description":"Unified product ID, mapped from sku","example":1},"sku":{"type":"integer","description":"Product SKU","example":1},"rating":{"type":"number","description":"Unified rating, mapped from reviewRating","example":1},"reviewRating":{"type":"number","description":"Product rating","example":1},"weight":{"type":"number","description":"Product weight, in grams","example":1},"sales":{"type":"integer","description":"Product sales in the last 30 days","example":1},"monthlySalesUnits":{"type":"integer","description":"Unified monthly sales, mapped from sales","example":1},"upTime":{"type":"integer","description":"Product listing time, millisecond timestamp","example":1},"price":{"type":"number","description":"Product price (RUB)","example":1},"currency":{"type":"string","description":"Currency, always ₽","example":null},"imageUrl":{"type":"string","description":"Unified main image URL","example":"https://example.com/image.jpg"},"fulfillment":{"type":"array","description":"Product fulfillment methods, e.g., [\"FBO\"], may contain multiple values","example":[]},"sellerType":{"type":"integer","description":"Seller type: 0 domestic, 1 cross-border","example":1},"returnCancellationRate":{"type":"number","description":"Product return/cancellation rate (%)","example":1},"sourceType":{"type":"string","description":"Data source, always ozon","example":null},"sourceTool":{"type":"string","description":"Source tool identifier for the Ozon shop endpoint","example":null}}}},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Shop product list, content identical to data","example":[],"items":{"type":"object","properties":{"productId":{"type":"integer","description":"Unified product ID, mapped from sku","example":1},"sku":{"type":"integer","description":"Product SKU","example":1},"rating":{"type":"number","description":"Unified rating, mapped from reviewRating","example":1},"reviewRating":{"type":"number","description":"Product rating","example":1},"weight":{"type":"number","description":"Product weight, in grams","example":1},"sales":{"type":"integer","description":"Product sales in the last 30 days","example":1},"monthlySalesUnits":{"type":"integer","description":"Unified monthly sales, mapped from sales","example":1},"upTime":{"type":"integer","description":"Product listing time, millisecond timestamp","example":1},"price":{"type":"number","description":"Product price (RUB)","example":1},"currency":{"type":"string","description":"Currency, always ₽","example":null},"imageUrl":{"type":"string","description":"Unified main image URL","example":"https://example.com/image.jpg"},"fulfillment":{"type":"array","description":"Product fulfillment methods, e.g., [\"FBO\"], may contain multiple values","example":[]},"sellerType":{"type":"integer","description":"Seller type: 0 domestic, 1 cross-border","example":1},"returnCancellationRate":{"type":"number","description":"Product return/cancellation rate (%)","example":1},"sourceType":{"type":"string","description":"Data source, always ozon","example":null},"sourceTool":{"type":"string","description":"Source tool identifier for the Ozon shop endpoint","example":null}}}},{"type":"null"}]},"hasNextPage":{"anyOf":[{"type":"boolean","description":"Whether there is a next page","example":false},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions, elements contain {field, title, cellType, sortable, filterable}","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Response display type, e.g., productWorkbenches","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"API latency (milliseconds)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"totalSales":1,"totalRevenue":1,"dailySales":1,"rating":1,"productCount":1,"fulfillment":{},"data":[{"productId":1,"sku":1,"rating":1,"reviewRating":1,"weight":1,"sales":1,"monthlySalesUnits":1,"upTime":1,"price":1,"imageUrl":"https://example.com/image.jpg","fulfillment":[],"sellerType":1,"returnCancellationRate":1}],"products":[{"productId":1,"sku":1,"rating":1,"reviewRating":1,"weight":1,"sales":1,"monthlySalesUnits":1,"upTime":1,"price":1,"imageUrl":"https://example.com/image.jpg","fulfillment":[],"sellerType":1,"returnCancellationRate":1}],"hasNextPage":false,"columns":[],"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ozon-shop-search","x-nexscope-mcp-tool-name":"nexscope_ozon_shop_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/patent-abstract-image-data/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Patent Abstract Image Data","description":"Retrieves patent abstract images (drawings) from the Nexscope (Nexscope) patent database by patent ID or publication number. Trigger when the user mentions patent abstract drawings, patent diagrams, patent figures, patent images, abstract drawing retrieval, patent image lookup, patent abstract images, patent drawings, patent illustrations, Nexscope, abstract image lookup. Also trigger when the user needs to view the drawings or figures in patent documents, even without explicitly mentioning Nexscope.","operationId":"runPatentAbstractImageData","externalDocs":{"description":"Patent Abstract Image Data documentation","url":"https://www.nexscope.ai/api-docs/patent-abstract-image-data"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.patent-abstract-image-data.","properties":{"patentId":{"type":"string","description":"Patent ID. At least one of patentId and patentNumber must be provided. If both are present, patentId takes precedence. Only a single value is supported; multiple values separated by commas are not allowed. Max length 60000 characters."},"patentNumber":{"type":"string","description":"Publication/announcement number. At least one of patentId and patentNumber must be provided. If both are present, patentId takes precedence. Only a single value is supported; multiple values separated by commas are not allowed. Max length 60000 characters.","example":"US11299876B2"}},"example":{"patentNumber":"US11299876B2"},"additionalProperties":true},"example":{"patentNumber":"US11299876B2"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Record count","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"List of patent abstract image results","example":[],"items":{"type":"object","properties":{"patentId":{"type":"string","description":"Patent ID","example":"example-id"},"pn":{"type":"string","description":"Publication (announcement) number","example":null},"abstractDrawingPath":{"type":"string","description":"Abstract image download path","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered column definitions","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendered style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"patentId":"example-id"}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"patent-abstract-image-data","x-nexscope-mcp-tool-name":"nexscope_patent_abstract_image_data","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/patent-claims/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Patent Claims","description":"Retrieves patent claims data from Nexscope (Nexscope). Trigger when the user mentions patent claims, claim text, independent claims, dependent claims, claim count, claims tree, claims analysis, claim scope, claim language, viewing the claims section of a specific patent, patent claims, independent claims, dependent claims, claims text, Nexscope. Also trigger when the user requests patent claims information by patent ID or publication number, even without explicitly mentioning Nexscope or Nexscope.","operationId":"runPatentClaims","externalDocs":{"description":"Patent Claims documentation","url":"https://www.nexscope.ai/api-docs/patent-claims"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.patent-claims.","properties":{"patentId":{"type":"string","description":"Nexscope internal patent ID. Only a single value is supported; multiple values separated by commas are not allowed. Max length 60000 characters"},"patentNumber":{"type":"string","description":"Publication/announcement number. Only a single value is supported; multiple values separated by commas are not allowed. Max length 60000 characters","example":"US11299876B2"},"replaceByRelated":{"type":"string","description":"Whether to substitute with a family patent's claims when the current patent's claims are unavailable: 1 yes, 0 no. Max length 1000 characters"}},"example":{"patentNumber":"US11299876B2"},"additionalProperties":true},"example":{"patentNumber":"US11299876B2"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Record count","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Patent list (see below)","example":[],"items":{"type":"object","properties":{"patentId":{"type":"string","description":"Patent ID","example":"example-id"},"pn":{"type":"string","description":"Publication (announcement) number","example":null},"pnRelated":{"type":"string","description":"Publication number of the substitute patent (only provided when a family patent substitute is used)","example":null},"claims":{"type":"array","description":"Claims array, containing claim text and metadata","example":[]},"claimCount":{"type":"integer","description":"Number of claims","example":1}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered column definitions","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendered style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"patentId":"example-id","claims":[],"claimCount":1}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"patent-claims","x-nexscope-mcp-tool-name":"nexscope_patent_claims","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/patent-cited-by/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Patent Cited By","description":"Returns cited-by counts and citing patent records for up to 100 patents.","operationId":"runPatentCitedBy","externalDocs":{"description":"Patent Cited By documentation","url":"https://www.nexscope.ai/api-docs/patent-cited-by"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Provide patentId or patentNumber. A request may contain at most 100 comma-separated patents.","properties":{"patentId":{"type":"string","description":"One or up to 100 comma-separated Nexscope patent IDs. Takes precedence when both identifiers are provided.","example":"patent-id"},"patentNumber":{"type":"string","description":"One or up to 100 comma-separated publication or grant numbers.","example":"US10123456B2"}},"example":{"patentNumber":"US10123456B2"},"additionalProperties":true},"example":{"patentNumber":"US10123456B2"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of returned patent records.","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Cited-by results.","example":[],"items":{"type":"object","properties":{"patentId":{"type":"string","description":"Queried patent ID.","example":"patent-id"},"pn":{"type":"string","description":"Queried publication number.","example":"US10123456B2"},"citedBy3y":{"type":"integer","description":"Citations received within three years.","example":1},"citedBy5y":{"type":"integer","description":"Citations received within five years.","example":1},"citedBySimpleFamily":{"type":"integer","description":"Cited patents in the simple family.","example":null},"citedByInpadocFamily":{"type":"integer","description":"Cited patents in the INPADOC family.","example":null},"citedByPatsnapFamily":{"type":"integer","description":"Cited patents in the Nexscope family.","example":null},"citedByPatents":{"type":"array","description":"Patents that cite the queried patent.","example":[]}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Provider rendering columns.","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider rendering style.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Provider-reported token cost.","example":6000},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"patentId":"patent-id","pn":"US10123456B2","citedBy3y":1,"citedBy5y":1,"citedByPatents":[]}],"columns":[],"costToken":6000},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"patent-cited-by","x-nexscope-mcp-tool-name":"nexscope_patent_cited_by","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/patent-claims-translation/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Patent Claims Translation","description":"Retrieves translated patent claims from the Nexscope (Nexscope) patent database. Trigger when the user asks about patent claims, claims translation, viewing claims in specific languages (Chinese, English, or Japanese), querying patent claims by patent ID or publication number, analyzing claim text, claim translation, patent claim translation, Nexscope, patent translation. Also trigger when the user needs patent claim content in a specific language, even without explicitly mentioning translated claims.","operationId":"runPatentClaimsTranslation","externalDocs":{"description":"Patent Claims Translation documentation","url":"https://www.nexscope.ai/api-docs/patent-claims-translation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.patent-claims-translation.","properties":{"patentId":{"type":"string","description":"Patent ID. Only a single value is supported; multiple values separated by commas are not allowed. When both patentNumber and this are present, the patent ID takes precedence. Max length: 60000 characters"},"patentNumber":{"type":"string","description":"Publication (announcement) number. Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60000 characters","example":"CN115000000A"},"lang":{"type":"string","description":"Translation language. Supports en (English, default), cn (Chinese), jp (Japanese). Max length: 1000 characters","example":"en"},"replaceByRelated":{"type":"integer","description":"Whether to substitute with a family patent when claims are unavailable: 1 yes, 0 no (default)","example":1}},"example":{"patentNumber":"CN115000000A","lang":"en","replaceByRelated":1},"additionalProperties":true},"example":{"patentNumber":"CN115000000A","lang":"en","replaceByRelated":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Record count","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Patent list (see below)","example":[],"items":{"type":"object","properties":{"patentId":{"type":"string","description":"Patent ID","example":"example-id"},"pn":{"type":"string","description":"Publication (announcement) number","example":null},"pnRelated":{"type":"string","description":"Publication number of the substitute patent (only provided when a family patent substitute is used)","example":null},"claims":{"type":"string","description":"Claims translation text","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered column definitions","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendered style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"patentId":"example-id"}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"patent-claims-translation","x-nexscope-mcp-tool-name":"nexscope_patent_claims_translation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/patent-description-data/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Patent Description Data","description":"Retrieve patent description (specification) data from the Nexscope patent database by patent ID or publication number. Triggered when users mention patent specification, patent full text, patent technical description, patent embodiment details, Nexscope specification data, patent specification, patent full text, technical description, embodiment details, Nexscope, or patent detailed description. Even if the user does not explicitly say \"Nexscope,\" this skill should be triggered whenever they need to view the complete specification/description content of one or more patents.","operationId":"runPatentDescriptionData","externalDocs":{"description":"Patent Description Data documentation","url":"https://www.nexscope.ai/api-docs/patent-description-data"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.patent-description-data.","properties":{"patentId":{"type":"string","description":"Patent ID (at least one of patentId and patentNumber must be provided; if both are present, patentId takes priority). Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60000 characters."},"patentNumber":{"type":"string","description":"Publication/grant number (at least one of patentId and patentNumber must be provided; if both are present, patentId takes priority). Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60000 characters.","example":"US11299876B2"},"replaceByRelated":{"type":"string","description":"Whether to substitute with a family patent's description when the current patent's description is unavailable: 1 Yes, 0 No. Max length: 1000 characters."}},"example":{"patentNumber":"US11299876B2"},"additionalProperties":true},"example":{"patentNumber":"US11299876B2"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of patent records returned","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Patent list, each element contains description data","example":[],"items":{"type":"object","properties":{"patentId":{"type":"string","description":"Patent ID","example":"example-id"},"pn":{"type":"string","description":"Publication (grant) number","example":null},"pnRelated":{"type":"string","description":"Publication number of the substitute patent (only provided when family patent substitution is used)","example":null},"description":{"type":"array","description":"Description content sections","example":[]}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions for rendering","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"patentId":"example-id","description":[]}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"patent-description-data","x-nexscope-mcp-tool-name":"nexscope_patent_description_data","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/patent-core-bibliography/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Patent Core Bibliography","description":"Returns titles, abstracts, identifiers, dates, applicants, inventors, assignees, and classifications.","operationId":"runPatentCoreBibliography","externalDocs":{"description":"Patent Core Bibliography documentation","url":"https://www.nexscope.ai/api-docs/patent-core-bibliography"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Provide patentId or patentNumber. A request may contain at most 100 comma-separated patents.","properties":{"patentId":{"type":"string","description":"One or up to 100 comma-separated Nexscope patent IDs. Takes precedence when both identifiers are provided.","example":"patent-id"},"patentNumber":{"type":"string","description":"One or up to 100 comma-separated publication or grant numbers.","example":"US10123456B2"}},"example":{"patentNumber":"US10123456B2"},"additionalProperties":true},"example":{"patentNumber":"US10123456B2"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of returned records.","example":1},{"type":"null"}]},"allRecordsCount":{"anyOf":[{"type":"integer","description":"Total matching record count.","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Bibliographic patent records.","example":[],"items":{"type":"object","properties":{"patentId":{"type":"string","description":"Patent ID.","example":"patent-id"},"title":{"type":"string","description":"Patent title.","example":"Wireless speaker system"},"abstractContent":{"type":"string","description":"Patent abstract.","example":"A wireless speaker system..."},"publicationNumber":{"type":"string","description":"Publication number.","example":"US10123456B2"},"pn":{"type":"string","description":"Publication or grant number.","example":null},"country":{"type":"string","description":"Country code.","example":null},"publicationCountry":{"type":"string","description":"Publication country.","example":null},"publicationDate":{"type":"string","description":"Publication date.","example":null},"publicationKind":{"type":"string","description":"Publication kind code.","example":null},"patentType":{"type":"string","description":"Patent type.","example":null},"kind":{"type":"string","description":"Patent kind code.","example":null},"applicationNo":{"type":"string","description":"Application number.","example":"US15/123456"},"applicationDate":{"type":"string","description":"Application date.","example":null},"applicants":{"type":"array","description":"Applicants.","example":[]},"inventors":{"type":"array","description":"Inventors.","example":[]},"assignees":{"type":"array","description":"Assignees.","example":[]},"assigneeAddresses":{"type":"array","description":"Assignee addresses.","example":[]},"ipcMain":{"type":"string","description":"Main IPC classification.","example":null},"ipcFurther":{"type":"array","description":"IPC classifications.","example":[]},"cpcMain":{"type":"string","description":"Main CPC classification.","example":null},"cpcFurther":{"type":"array","description":"Additional CPC classifications.","example":[]},"loc":{"type":"array","description":"LOC classifications.","example":[]},"gbc":{"type":"array","description":"GBC classifications.","example":[]},"priorityClaims":{"type":"array","description":"Priority claims.","example":[]},"pctApplicationNo":{"type":"string","description":"PCT application number.","example":null},"pctFilingDate":{"type":"string","description":"PCT filing date.","example":null},"pctEntryDate":{"type":"string","description":"PCT entry date.","example":null},"citedPatents":{"type":"array","description":"Cited patents.","example":[]},"citedNonPatents":{"type":"array","description":"Cited non-patent literature.","example":[]}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Provider rendering columns.","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider render style.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Provider-reported token cost.","example":6000},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"allRecordsCount":1,"data":[{"patentId":"patent-id","title":"Wireless speaker system","abstractContent":"A wireless speaker system...","publicationNumber":"US10123456B2","applicationNo":"US15/123456","applicants":[],"inventors":[],"assignees":[],"assigneeAddresses":[],"ipcFurther":[],"cpcFurther":[],"loc":[],"gbc":[],"priorityClaims":[],"citedPatents":[],"citedNonPatents":[]}],"columns":[],"costToken":6000},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"patent-core-bibliography","x-nexscope-mcp-tool-name":"nexscope_patent_core_bibliography","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/patent-description-data-translation/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Patent Description Data Translation","description":"Retrieve translated patent description (specification) text from Nexscope. Triggered when users request patent specification translation, patent full text in other languages, translated patent full text, or want to view patent specifications in Chinese, English, or Japanese, patent specification translation, patent description translation, Nexscope, or patent translation. Also triggered when users provide a patent ID or publication number and request specification/description content in another language, or mention \"patent specification translation,\" \"description translation,\" \"translated full text,\" or similar intent.","operationId":"runPatentDescriptionDataTranslation","externalDocs":{"description":"Patent Description Data Translation documentation","url":"https://www.nexscope.ai/api-docs/patent-description-data-translation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.patent-description-data-translation.","properties":{"patentId":{"type":"string","description":"Patent ID. At least one of patentId and patentNumber must be provided; if both are present, patentId takes priority. Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60000 characters"},"patentNumber":{"type":"string","description":"Publication (grant) number. At least one of patentId and patentNumber must be provided; if both are present, patentId takes priority. Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60000 characters","example":"CN115000000A"},"lang":{"type":"string","description":"Translation language, supports en (English, default), cn (Chinese), jp (Japanese). Max length: 1000 characters","example":"en"},"replaceByRelated":{"type":"integer","description":"Whether to substitute with a family patent's description when the description is unavailable: 1 Yes, 0 No (default 0)","example":1}},"example":{"patentNumber":"CN115000000A","lang":"en","replaceByRelated":1},"additionalProperties":true},"example":{"patentNumber":"CN115000000A","lang":"en","replaceByRelated":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Patent list (see below)","example":[],"items":{"type":"object","properties":{"patentId":{"type":"string","description":"Patent ID","example":"example-id"},"pn":{"type":"string","description":"Publication (grant) number","example":null},"description":{"type":"string","description":"Translated description text","example":null},"pnRelated":{"type":"string","description":"Publication number of the substitute patent (only provided when family patent substitution is used)","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions for rendering","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"patentId":"example-id"}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"patent-description-data-translation","x-nexscope-mcp-tool-name":"nexscope_patent_description_data_translation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/patent-detailed-bibliography/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Patent Detailed Bibliography","description":"Query patent bibliographic (catalog) information from the Nexscope patent database by patent ID or publication number. Triggered when users mention patent bibliographic info queries, patent catalog information, patent applicant queries, patent inventor queries, patent classification codes, patent abstract retrieval, patent citation analysis, patent priority claims, patent application citations, patent examiner information, patent bibliographic data, inventor lookup, applicant lookup, patent classification, patent metadata, Nexscope, or patent citations. Even if the user does not explicitly mention \"bibliographic info,\" this skill should be triggered whenever their need involves querying detailed metadata for a specific patent by patent ID or publication number.","operationId":"runPatentDetailedBibliography","externalDocs":{"description":"Patent Detailed Bibliography documentation","url":"https://www.nexscope.ai/api-docs/patent-detailed-bibliography"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.patent-detailed-bibliography.","properties":{"patentId":{"type":"string","description":"Patent ID (at least one of patentId and patentNumber must be provided; if both are present, patentId takes priority). Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60,000 characters"},"patentNumber":{"type":"string","description":"Publication/grant number (at least one of patentId and patentNumber must be provided; if both are present, patentId takes priority). Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60,000 characters","example":"US11299876B2"}},"example":{"patentNumber":"US11299876B2"},"additionalProperties":true},"example":{"patentNumber":"US11299876B2"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Bibliography data list (see data fields below)","example":[],"items":{"type":"object","properties":{"patentId":{"type":"string","description":"Patent ID","example":"example-id"},"pn":{"type":"string","description":"Publication/grant number","example":null},"inventionTitle":{"type":"array","description":"Patent title language and name","example":[]},"abstracts":{"type":"array","description":"Patent abstract","example":[]},"patentType":{"type":"string","description":"Patent type. APPLICATION: invention application, PATENT: granted invention, UTILITY: utility model, DESIGN: design","example":null},"applicants":{"type":"array","description":"Original applicants","example":[]},"assignees":{"type":"array","description":"Current applicants (patentees)","example":[]},"inventors":{"type":"array","description":"Inventors","example":[]},"agents":{"type":"array","description":"Patent applicants","example":[]},"agency":{"type":"array","description":"Application agency","example":[]},"examiners":{"type":"array","description":"Examiner information","example":[]},"priorityClaims":{"type":"array","description":"Priority claims","example":[]},"applicationReference":{"type":"object","description":"Application filing reference data","example":{}},"publicationReference":{"type":"object","description":"Publication reference data","example":{}},"datesOfPublicAvailability":{"type":"object","description":"Public availability dates","example":{}},"classificationIpcr":{"type":"object","description":"IPC classification","example":{}},"classificationCpc":{"type":"object","description":"CPC classification","example":{}},"classificationUpc":{"type":"object","description":"US patent classification","example":{}},"classificationLoc":{"type":"array","description":"LOC classification","example":[]},"classificationFi":{"type":"array","description":"FI classification","example":[]},"classificationFterm":{"type":"array","description":"F-term classification","example":[]},"classificationGbc":{"type":"object","description":"GBC classification","example":{}},"referenceCitedPatents":{"type":"array","description":"Cited patent documents","example":[]},"referenceCitedOthers":{"type":"array","description":"Cited non-patent literature","example":[]},"relatedDocuments":{"type":"array","description":"Divisional/continuation application information","example":[]},"pctOrRegionalFilingData":{"type":"object","description":"PCT or regional phase filing data","example":{}},"pctOrRegionalPublishingData":{"type":"object","description":"PCT or regional phase publication data","example":{}},"exdt":{"type":"integer","description":"Nexscope estimated patent expiration date","example":1}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Columns for rendering","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"patentId":"example-id","inventionTitle":[],"abstracts":[],"applicants":[],"assignees":[],"inventors":[],"agents":[],"agency":[],"examiners":[],"priorityClaims":[],"applicationReference":{},"publicationReference":{},"datesOfPublicAvailability":{},"classificationIpcr":{},"classificationCpc":{},"classificationUpc":{},"classificationLoc":[],"classificationFi":[],"classificationFterm":[],"classificationGbc":{},"referenceCitedPatents":[],"referenceCitedOthers":[],"relatedDocuments":[],"pctOrRegionalFilingData":{},"pctOrRegionalPublishingData":{},"exdt":1}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"patent-detailed-bibliography","x-nexscope-mcp-tool-name":"nexscope_patent_detailed_bibliography","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/patent-family-data/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Patent Family Data","description":"Returns patent family identifiers and members for up to 100 patents.","operationId":"runPatentFamilyData","externalDocs":{"description":"Patent Family Data documentation","url":"https://www.nexscope.ai/api-docs/patent-family-data"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Provide patentId or patentNumber. A request may contain at most 100 comma-separated patents.","properties":{"patentId":{"type":"string","description":"One or up to 100 comma-separated Nexscope patent IDs. Takes precedence when both identifiers are provided.","example":"patent-id"},"patentNumber":{"type":"string","description":"One or up to 100 comma-separated publication or grant numbers.","example":"US10123456B2"}},"example":{"patentNumber":"US10123456B2"},"additionalProperties":true},"example":{"patentNumber":"US10123456B2"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of returned records.","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Patent family records.","example":[],"items":{"type":"object","properties":{"patentId":{"type":"string","description":"Queried patent ID.","example":"patent-id"},"pn":{"type":"string","description":"Publication number.","example":"US10123456B2"},"simpleFamilyId":{"type":"integer","description":"Simple family identifier.","example":1},"simpleFamily":{"type":"array","description":"Simple family members.","example":[]},"inpadocFamilyId":{"type":"integer","description":"INPADOC family identifier.","example":1},"inpadocFamily":{"type":"array","description":"INPADOC family members.","example":[]},"patsnapFamilyId":{"type":"integer","description":"Nexscope family identifier.","example":1},"patsnapFamily":{"type":"array","description":"Nexscope family members.","example":[]}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Provider rendering columns.","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider rendering style.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Provider-reported token cost.","example":6000},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"patentId":"patent-id","pn":"US10123456B2","simpleFamilyId":1,"simpleFamily":[],"inpadocFamilyId":1,"inpadocFamily":[],"patsnapFamilyId":1,"patsnapFamily":[]}],"columns":[],"costToken":6000},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"patent-family-data","x-nexscope-mcp-tool-name":"nexscope_patent_family_data","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/patent-fulltext-images/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Patent Fulltext Images","description":"Retrieve fulltext images (drawings, diagrams, charts) from patent documents by patent ID or publication number. Triggered when users ask about patent images, patent drawings, patent diagrams, patent illustrations, fulltext drawings, patent charts, patent technical drawings, or want to view/download embedded images in patent documents, patent fulltext drawings, patent diagrams, technical drawings, patent images, or Nexscope. Even if the user does not explicitly mention \"fulltext drawings,\" this skill should be triggered whenever their need involves obtaining visual content (drawings, diagrams, charts) from specific patents.","operationId":"runPatentFulltextImages","externalDocs":{"description":"Patent Fulltext Images documentation","url":"https://www.nexscope.ai/api-docs/patent-fulltext-images"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.patent-fulltext-images.","properties":{"patentId":{"type":"string","description":"Patent ID"},"patentNumber":{"type":"string","description":"Publication (grant) number","example":"US11299876B2"},"limit":{"type":"string","description":"Total number of images to return, max 100, default \"100\"","example":"10"},"offset":{"type":"string","description":"Offset","example":"0"}},"example":{"patentNumber":"US11299876B2","limit":"10","offset":"0"},"additionalProperties":true},"example":{"patentNumber":"US11299876B2","limit":"10","offset":"0"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Patent list","example":[],"items":{"type":"object","properties":{"patentId":{"type":"string","description":"Patent ID","example":"example-id"},"pn":{"type":"string","description":"Publication (grant) number","example":null},"fulltextImagePath":{"type":"string","description":"Image path","example":"https://example.com/image.jpg"},"imageType":{"type":"string","description":"Image type","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Columns for rendering","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"patentId":"example-id","fulltextImagePath":"https://example.com/image.jpg"}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"patent-fulltext-images","x-nexscope-mcp-tool-name":"nexscope_patent_fulltext_images","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/patent-legal-status-data/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Patent Legal Status Data","description":"Query patent legal status information from the Nexscope (Nexscope) database. Triggered when users mention patent legal status, patent validity check, patent status query, patent event history, simple legal status, legal events such as transfer, license, pledge, opposition, litigation, re-examination, patent legal status, patent validity, patent events, transfer/license/pledge, Nexscope, or patent status lookup. Also triggered when users ask whether a patent is active, inactive, pending, expired, granted, withdrawn, or revoked, or want to look up legal status by patent ID or publication number.","operationId":"runPatentLegalStatusData","externalDocs":{"description":"Patent Legal Status Data documentation","url":"https://www.nexscope.ai/api-docs/patent-legal-status-data"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.patent-legal-status-data.","properties":{"patentId":{"type":"string","description":"Patent ID. At least one of patentId and patentNumber must be provided; if both are present, patentId takes priority. Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60000 characters."},"patentNumber":{"type":"string","description":"Publication (grant) number. At least one of patentId and patentNumber must be provided; if both are present, patentId takes priority. Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60000 characters.","example":"US11299876B2"}},"example":{"patentNumber":"US11299876B2"},"additionalProperties":true},"example":{"patentNumber":"US11299876B2"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Patent legal status list","example":[],"items":{"type":"object","properties":{"patentId":{"type":"string","description":"Patent ID","example":"example-id"},"pn":{"type":"string","description":"Publication (grant) number","example":null},"simpleLegalStatus":{"type":"array","description":"Simple legal status. Options: Inactive, Active, Pending, Undetermined, PCT designated period, PCT designated expiration","example":[]},"legalStatus":{"type":"array","description":"Legal status. Options: Published, Examining, Granted, Double, Abandoned-Undetermined, Abandoned-Voluntarily, Abandoned-Deemed, Withdrawn-Undetermined, Withdrawn-Voluntarily, Withdrawn-Deemed, Rejected, Revoked, Expired, Non-Payment, Restoration, Ceased, P-Revoked, Discontinuation, PCT published, PCT entering(designated period), PCT entering(designated expiration), PCT unentered","example":[]},"eventStatus":{"type":"array","description":"Legal events. Options: Transfer, License, Pledge, Trust, Opposition, Re-examination, Customs, Litigation, Preservation, Invalid-procedure, Oral-procedure, Declassification, Double application","example":[]},"legalDate":{"type":"integer","description":"Legal status update date (timestamp)","example":1}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions for rendering","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"patentId":"example-id","simpleLegalStatus":[],"legalStatus":[],"eventStatus":[],"legalDate":1}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"patent-legal-status-data","x-nexscope-mcp-tool-name":"nexscope_patent_legal_status_data","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/patent-references/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Patent References","description":"Returns forward citation details for up to 100 patents.","operationId":"runPatentReferences","externalDocs":{"description":"Patent References documentation","url":"https://www.nexscope.ai/api-docs/patent-references"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Provide patentId or patentNumber. A request may contain at most 100 comma-separated patents.","properties":{"patentId":{"type":"string","description":"One or up to 100 comma-separated Nexscope patent IDs. Takes precedence when both identifiers are provided.","example":"patent-id"},"patentNumber":{"type":"string","description":"One or up to 100 comma-separated publication or grant numbers.","example":"US10123456B2"}},"example":{"patentNumber":"US10123456B2"},"additionalProperties":true},"example":{"patentNumber":"US10123456B2"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of returned records.","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Patent reference records.","example":[],"items":{"type":"object","properties":{"patentId":{"type":"string","description":"Queried patent ID.","example":"patent-id"},"pn":{"type":"string","description":"Publication number.","example":"US10123456B2"},"citedPatents":{"type":"array","description":"Cited patent references.","example":[]},"citedOthers":{"type":"array","description":"Cited non-patent literature.","example":[]}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Provider rendering columns.","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider rendering style.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Provider-reported token cost.","example":6000},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"patentId":"patent-id","pn":"US10123456B2","citedPatents":[],"citedOthers":[]}],"columns":[],"costToken":6000},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"patent-references","x-nexscope-mcp-tool-name":"nexscope_patent_references","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/patent-search/run":{"post":{"tags":["Patent Intelligence"],"summary":"Patent Search","description":"Searches Nexscope patents and returns matching publications and the full hit count.","operationId":"runPatentSearch","externalDocs":{"description":"Patent Search documentation","url":"https://www.nexscope.ai/api-docs/patent-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Search parameters for the patent provider.","properties":{"queryText":{"type":"string","description":"Optional patent Analytics query expression forwarded as documented by the provider.","example":"TI=(wireless speaker)"},"pageNum":{"type":"integer","description":"Page number.","example":1},"pageSize":{"type":"integer","description":"Results per page.","example":20}},"example":{"pageNum":1,"queryText":"TI=(wireless speaker)","pageSize":20},"additionalProperties":true},"example":{"pageNum":1,"queryText":"TI=(wireless speaker)","pageSize":20}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records returned in this response.","example":1},{"type":"null"}]},"allRecordsCount":{"anyOf":[{"type":"integer","description":"Total number of matching records.","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Matching patent records.","example":[],"items":{"type":"object","properties":{"patentId":{"type":"string","description":"Nexscope patent identifier.","example":"123456789"},"pn":{"type":"string","description":"Publication number.","example":"CN123456789A"},"title":{"type":"string","description":"Patent title.","example":"Virtual reality display"},"apdt":{"type":"integer","description":"Application date in YYYYMMDD form.","example":20200101},"pbdt":{"type":"integer","description":"Publication date in YYYYMMDD form.","example":20210101},"apno":{"type":"string","description":"Application number.","example":"CN202010000001"},"authority":{"type":"string","description":"Patent authority code.","example":"CN"},"inventor":{"type":"string","description":"Inventors separated by |.","example":"A | B"},"originalAssignee":{"type":"string","description":"Original assignees separated by |.","example":"Company A"},"currentAssignee":{"type":"string","description":"Current assignees separated by |.","example":"Company B"}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendering column metadata.","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendering style.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"allRecordsCount":1,"data":[{"patentId":"123456789","pn":"CN123456789A","title":"Virtual reality display","apdt":20200101,"pbdt":20210101,"apno":"CN202010000001","authority":"CN","inventor":"A | B","originalAssignee":"Company A","currentAssignee":"Company B"}],"columns":[]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"patent-search","x-nexscope-mcp-tool-name":"nexscope_patent_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/patent-title-abstract-translation/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Patent Title Abstract Translation","description":"Retrieve translated patent titles and abstracts from the Nexscope (Nexscope) patent database. Triggered when users request patent abstract translation, patent title translation, translated patent abstracts, patent content in other languages, patent abstracts in Chinese/English/Japanese, or need to look up abstracts and titles of specific patents by patent ID or publication number, patent abstract translation, patent title translation, Nexscope, patent translation, or abstract lookup. Also triggered when users mention Nexscope, Nexscope, or patent abstract queries, even if \"translation\" is not explicitly mentioned.","operationId":"runPatentTitleAbstractTranslation","externalDocs":{"description":"Patent Title Abstract Translation documentation","url":"https://www.nexscope.ai/api-docs/patent-title-abstract-translation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.patent-title-abstract-translation.","properties":{"patentId":{"type":"string","description":"Nexscope internal patent ID. Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60,000 characters"},"patentNumber":{"type":"string","description":"Publication (grant) number. Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60,000 characters","example":"CN115000000A"},"replaceByRelated":{"type":"integer","description":"Whether to substitute with a family patent's abstract when the abstract is unavailable: 1 Yes, 0 No. Default 0","example":1},"lang":{"type":"string","description":"Target translation language. Options: en (English, default), cn (Chinese), jp (Japanese). Max length: 1,000 characters","example":"en"}},"example":{"patentNumber":"CN115000000A","lang":"en","replaceByRelated":1},"additionalProperties":true},"example":{"patentNumber":"CN115000000A","lang":"en","replaceByRelated":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of patent records returned","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Patent list","example":[],"items":{"type":"object","properties":{"patentId":{"type":"string","description":"Nexscope internal patent ID","example":"example-id"},"pn":{"type":"string","description":"Publication (grant) number","example":null},"title":{"type":"string","description":"Title translation","example":null},"abstractText":{"type":"string","description":"Abstract translation","example":null},"pnRelated":{"type":"string","description":"Publication number of the substitute patent (only provided when family patent substitution is used)","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions for rendering","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"patentId":"example-id"}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"patent-title-abstract-translation","x-nexscope-mcp-tool-name":"nexscope_patent_title_abstract_translation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/product-description-generator/run":{"post":{"tags":["Ecommerce Content Generation"],"summary":"Product Description Generator","description":"Creates a text-generation task from product copy instructions and image URLs, or queries a known task ID.","operationId":"runProductDescriptionGenerator","externalDocs":{"description":"Product Description Generator documentation","url":"https://www.nexscope.ai/api-docs/product-description-generator"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Use operation=query with the provider taskId returned by create. Query is sent to the skill's /aigc/textTaskQuery endpoint; the system task-result endpoint is not used.","properties":{"operation":{"type":"string","description":"create (default) or query.","example":"create"},"prompt":{"type":"string","description":"Product-copy generation instruction; required by create.","example":"Write a product description for a wireless speaker."},"imageUrls":{"type":"array","items":{},"description":"Public image URLs used as visual context; required by create and may be empty.","example":[]},"thinkingLevel":{"type":"string","description":"Reasoning level required by create.","example":"minimal"},"model":{"type":"string","description":"Optional supported text-generation model.","example":"GEM_3_FLASH"},"memberId":{"type":"string","description":"Optional provider member identifier used by create and query.","example":"member-id"},"taskId":{"type":"string","description":"Provider task ID returned by create; required by operation=query.","example":"123456789"}},"example":{"operation":"create","thinkingLevel":"minimal","prompt":"Write a product description for a wireless speaker.","imageUrls":[]},"additionalProperties":true},"example":{"operation":"create","thinkingLevel":"minimal","prompt":"Write a product description for a wireless speaker.","imageUrls":[]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"taskId":{"anyOf":[{"type":"string","description":"Asynchronous generation task ID.","example":"123456789"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","description":"Task status such as PROCESSING, SUCCESS, or FAILED.","example":"PROCESSING"},{"type":"null"}]},"content":{"anyOf":[{"type":"string","description":"Generated product copy when the task succeeds.","example":"Example product description."},{"type":"null"}]},"promptTokens":{"anyOf":[{"type":"integer","description":"Input token count when the task succeeds.","example":120},{"type":"null"}]},"completionTokens":{"anyOf":[{"type":"integer","description":"Output token count when the task succeeds.","example":350},{"type":"null"}]},"totalTokens":{"anyOf":[{"type":"integer","description":"Total token count when the task succeeds.","example":470},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Provider-reported token cost.","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"123456789","status":"PROCESSING","content":"Example product description.","promptTokens":120,"completionTokens":350,"totalTokens":470,"costToken":1},"code":0,"msg":"Generation failed.","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"product-description-generator","x-nexscope-mcp-tool-name":"nexscope_product_description_generator","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ruiguan-copyright-detection/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Ruiguan Copyright Detection","description":"Detect image copyright infringement risks by comparing against a database of registered copyrighted works with similarity scoring, TRO litigation history, and radar-based infringement assessment. Triggered when users mention copyright detection, image infringement check, copyright risk analysis, TRO risk, copyright similarity search, rights owner lookup, or copyright compliance verification. Even if the user does not explicitly say \"copyright,\" this skill should be triggered whenever the need involves checking whether an image may infringe registered copyright works.","operationId":"runRuiguanCopyrightDetection","externalDocs":{"description":"Ruiguan Copyright Detection documentation","url":"https://www.nexscope.ai/api-docs/ruiguan-copyright-detection"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.ruiguan-copyright-detection.","properties":{"imageUrl":{"type":"string","description":"URL of the copyrighted image to inspect (maximum 1,000 characters)","example":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"},"topNumber":{"type":"integer","description":"Maximum number of matches to return (default 100, minimum 10, maximum 200)","example":10},"enableRadar":{"type":"boolean","description":"Whether to enable radar detection (default true)","example":false}},"required":["imageUrl","topNumber","enableRadar"],"example":{"topNumber":10,"enableRadar":false,"imageUrl":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"},"additionalProperties":true},"example":{"topNumber":10,"enableRadar":false,"imageUrl":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Detection results; see the fields below","example":[],"items":{"type":"object","properties":{"path":{"type":"string","description":"Path to the copyrighted artwork","example":null},"pathThumb":{"type":"string","description":"Thumbnail path for the copyrighted artwork","example":null},"similarity":{"type":"string","description":"Similarity score","example":null},"subRadarResult":{"type":"integer","description":"Radar result: 1 means infringement, 0 means no infringement, and null means radar detection was not performed","example":1},"copyrightUrl":{"type":"string","description":"Source URL","example":"https://example.com/image.jpg"},"copyrightCode":{"type":"string","description":"Copyright identifier","example":null},"rightsOwner":{"type":"string","description":"Rights owner","example":null},"link":{"type":"string","description":"Official copyright website URL","example":null},"troCase":{"type":"boolean","description":"Whether the copyright has a history of TRO enforcement","example":false},"troHolder":{"type":"boolean","description":"Whether the copyright belongs to a TRO rights holder","example":false}}}},{"type":"null"}]},"detectId":{"anyOf":[{"type":"string","description":"Detection ID","example":"example-id"},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions used for rendering","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendering style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"subRadarResult":1,"copyrightUrl":"https://example.com/image.jpg","troCase":false,"troHolder":false}],"detectId":"example-id","columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ruiguan-copyright-detection","x-nexscope-mcp-tool-name":"nexscope_ruiguan_copyright_detection","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ruiguan-detection-patent-design/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Ruiguan Detection Patent Design","description":"Detect design patent infringement risks by comparing a product image against a global design patent database across 25+ jurisdictions. Triggered when users mention design patent detection, patent infringement check, patent risk analysis, TRO case lookup, design patent search, product design patent screen, or visual patent similarity. Even if the user does not explicitly say \"design patent,\" this skill should be triggered whenever the need involves checking whether a product image may infringe existing design patents.","operationId":"runRuiguanDetectionPatentDesign","externalDocs":{"description":"Ruiguan Detection Patent Design documentation","url":"https://www.nexscope.ai/api-docs/ruiguan-detection-patent-design"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.ruiguan-detection-patent-design.","properties":{"imageUrl":{"type":"string","description":"Product image URL used for comparison with the patent database (maximum 1,000 characters)","example":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"},"queryMode":{"type":"string","description":"Search mode: physical for product-photo search, line for line-drawing search, or hybrid for combined search. Maximum 1,000 characters","example":"physical"},"topNumber":{"type":"integer","description":"Number of patents to return (maximum 100)","example":10},"regions":{"type":"string","description":"Country or region codes where the product is sold, separated by commas, for example US,EU,CN. Supported values: US, EU, CN, JP, KR, DE, GB, FR, IT, AU, CA, BR, MX, IN, TH, SE, CH, IE, IL, DK, NZ, AT, BX, FI, and WO. Maximum 1,000 characters","example":"US"},"productTitle":{"type":"string","description":"Product title used to provide additional search context (maximum 1,000 characters)","example":"Magnetic phone case"},"productDescription":{"type":"string","description":"Product description used to provide additional search context (maximum 1,000 characters)","example":"A protective smartphone case with a magnetic ring stand and shockproof corners."},"patentStatus":{"type":"string","description":"Patent-validity filter: 1 for active patents, 0 for inactive patents, or 1,0 for all patents. Maximum 1,000 characters","example":"1,0"},"enableRadar":{"type":"boolean","description":"Whether to enable AI radar analysis for potential infringement","example":false},"topLoc":{"type":"string","description":"Top-level LOC classes to search, for example 06,07. Pattern: ^(0[1-9]\\"},"sourceLanguage":{"type":"string","description":"Source-language code used to translate content into English, for example zh-CN. Leave empty when the text is already English. Maximum 1,000 characters"}},"required":["imageUrl","queryMode","topNumber"],"example":{"regions":"US","topNumber":10,"productDescription":"A protective smartphone case with a magnetic ring stand and shockproof corners.","queryMode":"physical","patentStatus":"1,0","productTitle":"Magnetic phone case","imageUrl":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg","enableRadar":false},"additionalProperties":true},"example":{"regions":"US","topNumber":10,"productDescription":"A protective smartphone case with a magnetic ring stand and shockproof corners.","queryMode":"physical","patentStatus":"1,0","productTitle":"Magnetic phone case","imageUrl":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg","enableRadar":false}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total number of patent records returned","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Patent records; see the patent fields below","example":[],"items":{"type":"object","properties":{"applicationNumber":{"type":"string","description":"Patent application number","example":null},"publicationNumber":{"type":"string","description":"Patent publication number","example":null},"patentProd":{"type":"string","description":"Patent title in English","example":null},"patentProdCn":{"type":"string","description":"Patent title in Chinese","example":null},"similarity":{"type":"string","description":"Similarity between the patent and product image (0-1)","example":null},"patentImageUrl":{"type":"string","description":"URL of the patent drawing most similar to the product image","example":"https://example.com/image.jpg"},"images":{"type":"array","description":"Patent image URLs","example":[]},"abstracts":{"type":"string","description":"Patent abstract","example":null},"specification":{"type":"string","description":"Patent specification","example":null},"inventors":{"type":"array","description":"Inventors","example":[]},"applicants":{"type":"array","description":"Applicants","example":[]},"applicantAddresses":{"type":"array","description":"Applicant addresses","example":[]},"troCase":{"type":"boolean","description":"Whether the patent has a history of TRO enforcement","example":false},"troHolder":{"type":"boolean","description":"Whether the patent belongs to a TRO rights holder","example":false},"radarResult":{"type":"object","description":"AI radar analysis result","example":{},"properties":{"same":{"type":"boolean","description":"Whether infringement is suspected","example":false},"exp":{"type":"string","description":"Radar decision explanation","example":null}}},"patentLoc":{"type":"string","description":"LOC classifications for the patent, separated by commas","example":null},"locOneInfo":{"type":"string","description":"Top-level LOC details","example":null},"locTwoInfo":{"type":"string","description":"Second-level LOC details","example":null},"patentValidity":{"type":"string","description":"Patent validity","example":null},"applicationDate":{"type":"string","description":"Patent application date","example":"2026-01-01"},"publicationDate":{"type":"string","description":"Patent publication date","example":"2026-01-01"},"grantDate":{"type":"string","description":"Patent grant date","example":"2026-01-01"},"estimatedDueDate":{"type":"string","description":"Estimated expiration date","example":"2026-01-01"},"registrationOfficeCode":{"type":"string","description":"Patent registration office","example":null},"patentFamily":{"type":"array","description":"Patent family","example":[]},"globalPatentId":{"type":"string","description":"Global patent ID","example":"example-id"},"globalImageId":{"type":"string","description":"Patent image ID","example":"example-id"},"isSketchText":{"type":"string","description":"Whether the image is a line drawing","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions used for rendering","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendering style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"patentImageUrl":"https://example.com/image.jpg","images":[],"inventors":[],"applicants":[],"applicantAddresses":[],"troCase":false,"troHolder":false,"radarResult":{"same":false},"applicationDate":"2026-01-01","publicationDate":"2026-01-01","grantDate":"2026-01-01","estimatedDueDate":"2026-01-01","patentFamily":[],"globalPatentId":"example-id","globalImageId":"example-id"}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ruiguan-detection-patent-design","x-nexscope-mcp-tool-name":"nexscope_ruiguan_detection_patent_design","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ruiguan-gun-parts-search/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Ruiguan Gun Parts Search","description":"Check product images against a database of policy-violating items using visual similarity matching. Triggered when users mention policy compliance check, product image compliance review, violation detection, prohibited product screening, image-based compliance audit, pre-listing risk screening, or product image risk check. Even if the user does not explicitly say \"compliance,\" this skill should be triggered whenever the need involves comparing product images against a violation database.","operationId":"runRuiguanGunPartsSearch","externalDocs":{"description":"Ruiguan Gun Parts Search documentation","url":"https://www.nexscope.ai/api-docs/ruiguan-gun-parts-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.ruiguan-gun-parts-search.","properties":{"imageUrl":{"type":"string","description":"URL of the product image to inspect (maximum 1,000 characters)","example":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"}},"required":["imageUrl"],"example":{"imageUrl":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"},"additionalProperties":true},"example":{"imageUrl":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Detected policy-violating products; see the fields below","example":[],"items":{"type":"object","properties":{"pdImgOssUrl":{"type":"string","description":"Image URL of the matched policy-violating product","example":"https://example.com/image.jpg"},"cosine":{"type":"number","description":"Similarity between the inspected product and the policy-violating product","example":1},"pdTitle":{"type":"string","description":"Title of the matched policy-violating product","example":null},"pdTitleCHNCensored":{"type":"string","description":"Chinese title of the matched policy-violating product","example":null}}}},{"type":"null"}]},"detectId":{"anyOf":[{"type":"string","description":"Detection record ID","example":"example-id"},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions used for rendering","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendering style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"pdImgOssUrl":"https://example.com/image.jpg","cosine":1}],"detectId":"example-id","columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ruiguan-gun-parts-search","x-nexscope-mcp-tool-name":"nexscope_ruiguan_gun_parts_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ruiguan-trademark-graphic-detection/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Ruiguan Trademark Graphic Detection","description":"Detect graphic trademarks in product images by comparing against registered trademark databases across 15 major trademark offices using YOLO-based object detection and visual similarity. Triggered when users mention graphic trademark detection, logo infringement check, trademark similarity analysis, image trademark risk assessment, product image trademark screening, or logo detection. Even if the user does not explicitly say \"trademark detection,\" this skill should be triggered whenever the need involves comparing a product image against registered graphic trademarks or assessing trademark infringement risk.","operationId":"runRuiguanTrademarkGraphicDetection","externalDocs":{"description":"Ruiguan Trademark Graphic Detection documentation","url":"https://www.nexscope.ai/api-docs/ruiguan-trademark-graphic-detection"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.ruiguan-trademark-graphic-detection.","properties":{"imageUrl":{"type":"string","description":"Product image URL or Base64-encoded image data (maximum 1,000 characters)","example":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"},"topNumber":{"type":"integer","description":"Maximum number of YOLO bounding boxes to return (default 5, maximum 100). The actual result count may be lower","example":1},"productTitle":{"type":"string","description":"Product title used for context-aware detection (maximum 1,000 characters)"},"trademarkName":{"type":"string","description":"Possible graphic-logo name used to narrow the search (maximum 1,000 characters)"},"regions":{"type":"string","description":"Comma-separated country or region codes to inspect. Defaults to all regions. Supported values: US (United States), WO (WIPO), ES (Spain), GB (United Kingdom), DE (Germany), IT (Italy), CA (Canada), MX (Mexico), EM (European Union), AU (Australia), FR (France), JP (Japan), TR (Turkey), BX (Benelux), and CN (China)","example":"US"},"enableLocalizing":{"type":"boolean","description":"Whether to enable image cropping (default false)","example":false},"enableRadar":{"type":"boolean","description":"Whether to enable radar monitoring (default true)","example":false}},"required":["imageUrl","topNumber"],"example":{"enableRadar":false,"enableLocalizing":false,"topNumber":10,"imageUrl":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg","regions":"US"},"additionalProperties":true},"example":{"enableRadar":false,"enableLocalizing":false,"topNumber":10,"imageUrl":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg","regions":"US"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"boundingBoxCount":{"anyOf":[{"type":"integer","description":"Number of detection results","example":1},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"Number of records","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Detection results; see the fields below","example":[],"items":{"type":"object","properties":{"radarResult":{"anyOf":[{"type":"string","description":"Radar detection result","example":null},{"type":"null"}]},"image":{"type":"string","description":"URL of the matched trademark image","example":"https://example.com/image.jpg"},"boundingBox":{"type":"string","description":"Comma-separated YOLO coordinates","example":null},"subRadarResult":{"type":"string","description":"Sub-radar detection result","example":null},"applicationNumber":{"type":"string","description":"Application number","example":null},"niceClassName":{"type":"string","description":"Comma-separated Nice Classification names","example":null},"applicantName":{"type":"string","description":"Comma-separated rights-holder names","example":null},"tradeMarkStatus":{"type":"string","description":"Trademark status. Values: \"DEL\", \"ended\", \"registered\", \"act\", \"pend\", \"filed\", or an empty string","example":null},"niceClass":{"type":"array","description":"Nice Classification details","example":[]},"similarity":{"type":"number","description":"Similarity score from 0 to 1; higher values indicate greater similarity","example":1},"registrationNumber":{"type":"string","description":"Registration number","example":null},"registrationOfficeCode":{"type":"string","description":"Trademark registration office","example":null},"registrationDate":{"type":"string","description":"Registration date","example":"2026-01-01"},"bid":{"type":"string","description":"Logo identifier","example":"example-id"},"trademarkName":{"type":"string","description":"Text trademark name found in the image","example":null},"applicationDate":{"type":"string","description":"Application date","example":"2026-01-01"}}}},{"type":"null"}]},"detectId":{"anyOf":[{"type":"string","description":"Detection ID","example":"example-id"},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions used for rendering","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendering style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"boundingBoxCount":1,"total":1,"data":[{"image":"https://example.com/image.jpg","niceClass":[],"similarity":1,"registrationDate":"2026-01-01","bid":"example-id","applicationDate":"2026-01-01"}],"detectId":"example-id","columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ruiguan-trademark-graphic-detection","x-nexscope-mcp-tool-name":"nexscope_ruiguan_trademark_graphic_detection","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/shopee-product-search/run":{"post":{"tags":["Shopee Marketplace"],"summary":"Shopee Product Search","description":"YouYing Shopee product selection tool supporting product query and filtering across all Shopee marketplaces, covering Malaysia, Taiwan (China), Indonesia, Thailand, Philippines, Singapore, Vietnam, Brazil, Mexico, Chile, and Colombia. Triggered when users mention Shopee product selection, Shopee product search, Shopee bestsellers, Shopee market analysis, Shopee category selection, Shopee keyword selection, Shopee sales filtering, Shopee price filtering, Southeast Asia e-commerce product selection, Shopee product search, Shopee product selection, Shopee bestsellers, or Shopee market analysis. Even if the user does not explicitly mention \"YouYing\" or \"Shopee,\" this skill should be triggered whenever their need involves searching for products or filtering Shopee product data on the Shopee platform.","operationId":"runShopeeProductSearch","externalDocs":{"description":"Shopee Product Search documentation","url":"https://www.nexscope.ai/api-docs/shopee-product-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.shopee-product-search.","properties":{"station":{"type":"string","description":"Required. Shopee site, accepts name or code. See site mapping table below","example":"SG"},"keyword":{"type":"string","description":"Product title keyword","example":"phone case"},"keywordType":{"type":"integer","description":"Match mode: 1=Exact phrase (default), 2=Multi-word AND, 3=Multi-word OR","example":1},"notExistKeyword":{"type":"string","description":"Exclude products containing this keyword","example":"phone case"},"notExistKeywordType":{"type":"integer","description":"Exclusion match mode: 1=Exact phrase (default), 2=Multi-word AND, 3=Multi-word OR","example":1},"priceMin":{"type":"number","description":"Minimum total product price (local currency)","example":1},"priceMax":{"type":"number","description":"Maximum total product price","example":1},"soldMin":{"type":"integer","description":"Minimum units sold in last 30 days","example":1},"soldMax":{"type":"integer","description":"Maximum units sold in last 30 days","example":1},"estimateSoldStart":{"type":"integer","description":"Minimum estimated units sold in last 30 days","example":1},"estimateSoldEnd":{"type":"integer","description":"Maximum estimated units sold in last 30 days","example":1},"historicalSoldStart":{"type":"integer","description":"Minimum total historical units sold","example":1},"historicalSoldEnd":{"type":"integer","description":"Maximum total historical units sold","example":1},"paymentStart":{"type":"number","description":"Minimum sales revenue in last 30 days","example":1},"paymentEnd":{"type":"number","description":"Maximum sales revenue in last 30 days","example":1},"ratingMin":{"type":"number","description":"Minimum product rating (0-5)","example":1},"ratingMax":{"type":"number","description":"Maximum product rating","example":1},"ratingsMin":{"type":"integer","description":"Minimum number of ratings","example":1},"ratingsMax":{"type":"integer","description":"Maximum number of ratings","example":1},"favoriteMin":{"type":"integer","description":"Minimum number of favorites","example":1},"favoriteMax":{"type":"integer","description":"Maximum number of favorites","example":1},"skuNumberStart":{"type":"integer","description":"Minimum total SKU count","example":1},"skuNumberEnd":{"type":"integer","description":"Maximum total SKU count","example":1},"listingDateFrom":{"type":"string","description":"Product listing date range start (format: yyyy-MM-dd)","example":"2026-01-01"},"listingDateTo":{"type":"string","description":"Product listing date range end (format: yyyy-MM-dd)","example":"2026-01-01"},"statTimeStart":{"type":"string","description":"Statistics time range start (format: yyyy-MM-dd HH:mm:ss)"},"statTimeEnd":{"type":"string","description":"Statistics time range end (format: yyyy-MM-dd HH:mm:ss)"},"lastModiTimeStart":{"type":"string","description":"Latest crawl time range start (format: yyyy-MM-dd)"},"lastModiTimeEnd":{"type":"string","description":"Latest crawl time range end (format: yyyy-MM-dd)"},"approvedDateStart":{"type":"string","description":"Store opening time range start (format: yyyy-MM-dd)","example":"2026-01-01"},"approvedDateEnd":{"type":"string","description":"Store opening time range end (format: yyyy-MM-dd)","example":"2026-01-01"},"pL1Id":{"type":"string","description":"Level 1 category ID","example":"example-id"},"pL2Id":{"type":"string","description":"Level 2 category ID","example":"example-id"},"pL3Id":{"type":"string","description":"Level 3 category ID","example":"example-id"},"cidList":{"type":"string","description":"Category ID list, full path, multiple groups separated by"},"shopIdList":{"type":"string","description":"Specific store ID list, comma-separated"},"notExistShopIdList":{"type":"string","description":"Excluded store ID list, comma-separated"},"merchant":{"type":"string","description":"Store name or username"},"shopLocation":{"type":"string","description":"Store location"},"shippingIconType":{"type":"integer","description":"Store location type: 0=Local, 1=Overseas","example":1},"cbOption":{"type":"integer","description":"Shipping origin: 0=Local, 1=Cross-border","example":1},"isShopeeVerified":{"type":"integer","description":"Shopee Preferred: 0=Not preferred, 1=Preferred","example":1},"isOfficialShop":{"type":"integer","description":"Official store: 0=No, 1=Yes","example":1},"isHotSales":{"type":"integer","description":"Hot selling: 0=Not hot, 1=Hot","example":1},"pids":{"type":"string","description":"Product ID list (max 500), comma-separated"},"orderBy":{"type":"string","description":"Sort field: rating, price, historical_sold (total sales), sold (30-day sales), payment (30-day revenue), favorite, ratings, gen_time (listing time), estimate_sold (estimated sales)"},"orderByType":{"type":"string","description":"Sort direction: ASC (ascending), DESC (descending)"},"page":{"type":"integer","description":"Page number (starting from 1)","example":1},"pageSize":{"type":"integer","description":"Products per page (range 1-1000)","example":10}},"required":["station"],"example":{"station":"SG","pageSize":10,"keywordType":1,"keyword":"phone case","page":1},"additionalProperties":true},"example":{"station":"SG","pageSize":10,"keywordType":1,"keyword":"phone case","page":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records returned in current response","example":1},{"type":"null"}]},"totalSize":{"anyOf":[{"type":"integer","description":"Total number of results","example":1},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Source tool identifier","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type: shopee","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions for rendering","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list (see fields below)","example":[],"items":{"type":"object","properties":{"pid":{"type":"string","description":"Unique product ID","example":"example-id"},"title":{"type":"string","description":"Product title","example":null},"description":{"type":"string","description":"Product description","example":null},"imageUrl":{"type":"string","description":"Product main image URL","example":"https://example.com/image.jpg"},"productUrl":{"type":"string","description":"Shopee product link","example":"https://example.com/image.jpg"},"shopeeUrl":{"type":"string","description":"Shopee-domain product link","example":"https://shopee.sg/example-i.1.2"},"price":{"type":"number","description":"Default product price (local currency)","example":1},"minPrice":{"type":"number","description":"Lowest SKU price","example":1},"maxPrice":{"type":"number","description":"Highest SKU price","example":1},"sold":{"type":"integer","description":"Units sold in last 30 days","example":1},"estimateSold":{"type":"integer","description":"Estimated units sold in last 30 days","example":1},"historicalSold":{"type":"integer","description":"Total historical units sold","example":1},"payment":{"type":"number","description":"Sales revenue in last 30 days (local currency)","example":1},"rating":{"type":"number","description":"Product rating (0-5)","example":1},"ratings":{"type":"integer","description":"Number of ratings","example":1},"favorite":{"type":"integer","description":"Number of favorites","example":1},"viewCount":{"type":"integer","description":"View count","example":1},"stock":{"type":"integer","description":"Stock quantity","example":1},"skuNumber":{"type":"integer","description":"Number of SKUs","example":1},"genTime":{"type":"string","description":"Listing time","example":null},"statTime":{"type":"string","description":"Statistics time","example":null},"lastModiTime":{"type":"string","description":"Latest crawl time","example":null},"categoryStructure":{"type":"string","description":"Category structure path","example":null},"cid":{"type":"string","description":"Category ID (comma-separated)","example":"example-id"},"shopId":{"type":"string","description":"Store ID","example":"example-id"},"shopName":{"type":"string","description":"Store name","example":null},"shopUrl":{"type":"string","description":"Store link","example":"https://example.com/image.jpg"},"userName":{"type":"string","description":"Store owner name","example":null},"shopLocation":{"type":"string","description":"Store location","example":null},"shopProductsCount":{"type":"integer","description":"Total products in store","example":1},"approvedDate":{"type":"string","description":"Store opening time","example":"2026-01-01"},"isOfficialShop":{"type":"integer","description":"Whether official store (1=Yes, 0=No)","example":1},"isShopeeVerified":{"type":"integer","description":"Shopee Preferred (1=Yes, 0=No)","example":1},"isHotSales":{"type":"integer","description":"Whether hot selling (1=Yes, 0=No)","example":1},"shippingIconType":{"type":"integer","description":"Store location type (0=Local, 1=Overseas, 3 or null=Unknown)","example":1},"cbOption":{"type":"integer","description":"Shipping origin (0=Local, 1=Cross-border)","example":1},"estimatedDays":{"type":"integer","description":"Estimated delivery days","example":1},"status":{"type":"integer","description":"Product status (1=Active, 0=Delisted, 8=Excluded from listing)","example":1},"notExist":{"type":"integer","description":"Whether exists (0=Exists, 1=Does not exist)","example":1}}}},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"totalSize":1,"columns":[],"costToken":1,"products":[{"pid":"example-id","imageUrl":"https://example.com/image.jpg","productUrl":"https://example.com/image.jpg","shopeeUrl":"https://shopee.sg/example-i.1.2","price":1,"minPrice":1,"maxPrice":1,"sold":1,"estimateSold":1,"historicalSold":1,"payment":1,"rating":1,"ratings":1,"favorite":1,"viewCount":1,"stock":1,"skuNumber":1,"cid":"example-id","shopId":"example-id","shopUrl":"https://example.com/image.jpg","shopProductsCount":1,"approvedDate":"2026-01-01","isOfficialShop":1,"isShopeeVerified":1,"isHotSales":1,"shippingIconType":1,"cbOption":1,"estimatedDays":1,"status":1,"notExist":1}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"shopee-product-search","x-nexscope-mcp-tool-name":"nexscope_shopee_product_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/shopify-product-query/run":{"post":{"tags":["Shopify Commerce"],"summary":"Shopify Product Query","description":"Filter Shopify standalone store products by multiple dimensions (keyword/URL, price, weekly sales, listing date, Facebook ads, competitiveness, supplier availability, shipping country, etc.). Triggered when users mention Shopify products, Shopify product selection, standalone store product selection, Shopify bestsellers, Shopify dropshipping, standalone store sourcing, Facebook ad products, Shopify product query, or shopify items. Even if the user does not mention the tool name, this skill should be triggered whenever searching for products, viewing weekly sales/revenue/competitiveness, or filtering products on Shopify standalone stores.","operationId":"runShopifyProductQuery","externalDocs":{"description":"Shopify Product Query documentation","url":"https://www.nexscope.ai/api-docs/shopify-product-query"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.shopify-product-query.","properties":{"searchKey":{"type":"string","description":"Keyword or Shopify product/store URL"},"priceMin":{"type":"number","description":"Price range start (USD), combined with priceMax to form upstream price","example":1},"priceMax":{"type":"number","description":"Price range end (USD)","example":1},"salesWeeklyMin":{"type":"integer","description":"Weekly sales range start","example":1},"salesWeeklyMax":{"type":"integer","description":"Weekly sales range end","example":1},"publishedTimeBegin":{"type":"string","description":"Listing date range start"},"publishedTimeEnd":{"type":"string","description":"Listing date range end"},"facebookAd":{"type":"integer","description":"Has Facebook ad: 1=Yes","example":1},"competitionMin":{"type":"integer","description":"Competition (number of stores selling) range start","example":1},"competitionMax":{"type":"integer","description":"Competition (number of stores selling) range end","example":1},"hasSupplier":{"type":"integer","description":"Has supplier: 1=Yes, 0=No","example":1},"showDeleted":{"type":"integer","description":"Show delisted products: 1=Yes, 0=No","example":1},"country":{"type":"string","description":"Shipping country (two-letter country code, e.g., US)"},"sortBy":{"type":"integer","description":"Sort field (default 14=Weekly sales descending; also includes price/ad count/competition/revenue etc. values, see enumeration below)","example":1},"page":{"type":"integer","description":"Page number (starting from 1)","example":1},"pageSize":{"type":"integer","description":"Results per page, max 100, recommended not to exceed 50","example":1},"keyword":{"type":"string"}},"example":{"page":1,"keyword":"phone case","pageSize":10},"additionalProperties":true},"example":{"page":1,"keyword":"phone case","pageSize":10}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of results returned on this page","example":1},{"type":"null"}]},"productNum":{"anyOf":[{"type":"integer","description":"Total number of matching products (upstream product_num)","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Shopify product list","example":[],"items":{"type":"object","properties":{"productId":{"type":"string","description":"Product ID","example":"example-id"},"title":{"type":"string","description":"Product title","example":null},"productLink":{"type":"string","description":"Product link","example":null},"previewImageUrl":{"type":"string","description":"Main image URL","example":"https://example.com/image.jpg"},"country":{"type":"string","description":"Shipping country","example":null},"minPrice":{"type":"string","description":"Minimum price","example":null},"maxPrice":{"type":"string","description":"Maximum price","example":null},"storeId":{"type":"string","description":"Store ID","example":"example-id"},"shopId":{"type":"string","description":"Shopify shop ID","example":"example-id"},"storeLink":{"type":"string","description":"Store link","example":null},"storeRank":{"type":"string","description":"Store rank","example":null},"competitorCount":{"type":"string","description":"Competition (number of stores selling)","example":null},"facebookAdCount":{"type":"string","description":"Facebook ad count","example":null},"weekOrderCount":{"type":"string","description":"Weekly order count (string)","example":null},"weekRevenueCount":{"type":"string","description":"Weekly revenue","example":null},"weekRevenueGrowth":{"type":"string","description":"Weekly revenue growth rate (%)","example":null},"shelfTime":{"type":"string","description":"Listing time","example":null},"isDeleted":{"type":"string","description":"Whether delisted: 0=Listed, 1=Delisted","example":null},"isFavourite":{"type":"string","description":"Whether favorited","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Columns for rendering","example":[]},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Title (Shopify Product Query)","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type: shopify","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Tool type: ehunt","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style: tableListWorkbenches","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"productNum":1,"products":[{"productId":"example-id","previewImageUrl":"https://example.com/image.jpg","storeId":"example-id","shopId":"example-id"}],"columns":[]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"shopify-product-query","x-nexscope-mcp-tool-name":"nexscope_shopify_product_query","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/shopify-store-query/run":{"post":{"tags":["Shopify Commerce"],"summary":"Shopify Store Query","description":"Filter Shopify standalone stores by multiple dimensions (store name/domain, country, years since creation, product count, ad count, monthly visits, monthly orders, social media followers, etc.). Triggered when users mention Shopify stores, Shopify store analysis, standalone stores, Shopify sellers, competitor standalone stores, Shopify monthly visits, standalone store ad library, shopify stores, or Shopify store query. Even if the user does not mention the tool name, this skill should be triggered whenever searching for stores, filtering store data, or analyzing store performance on Shopify standalone stores.","operationId":"runShopifyStoreQuery","externalDocs":{"description":"Shopify Store Query documentation","url":"https://www.nexscope.ai/api-docs/shopify-store-query"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.shopify-store-query.","properties":{"searchKey":{"type":"string","description":"Store name or domain keyword"},"country":{"type":"string","description":"Country code (e.g., US, CN)"},"year":{"type":"integer","description":"Store creation year: 1=Last 1 year, 2=1~2 years, 3=2~3 years, 4=3+ years","example":1},"productNumMin":{"type":"integer","description":"Product count range start","example":1},"productNumMax":{"type":"integer","description":"Product count range end","example":1},"advertiseCountMin":{"type":"integer","description":"Ad count range start","example":1},"advertiseCountMax":{"type":"integer","description":"Ad count range end","example":1},"monthlyVisitMin":{"type":"integer","description":"Monthly visits range start","example":1},"monthlyVisitMax":{"type":"integer","description":"Monthly visits range end","example":1},"monthOrderMin":{"type":"integer","description":"Monthly orders range start","example":1},"monthOrderMax":{"type":"integer","description":"Monthly orders range end","example":1},"sortBy":{"type":"integer","description":"Sort field: 0=Product count, 1=Category count, 2=Monthly visits, 3=FB followers, 4=Ins followers, 5=Ad count, 6=Relevance, 7=Monthly orders (default)","example":1},"orderBy":{"type":"string","description":"Sort direction: desc (default) / asc"},"page":{"type":"integer","description":"Page number (starting from 1)","example":1},"pageSize":{"type":"integer","description":"Results per page, max 100","example":1},"keyword":{"type":"string"}},"example":{"page":1,"keyword":"phone case","pageSize":10},"additionalProperties":true},"example":{"page":1,"keyword":"phone case","pageSize":10}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of results returned on this page","example":1},{"type":"null"}]},"storeNum":{"anyOf":[{"type":"integer","description":"Total number of matching stores (upstream store_num)","example":1},{"type":"null"}]},"stores":{"anyOf":[{"type":"array","description":"Shopify store list","example":[],"items":{"type":"object","properties":{"storeId":{"type":"string","description":"Store ID","example":"example-id"},"shopId":{"type":"string","description":"Shopify shop ID","example":"example-id"},"storeName":{"type":"string","description":"Store name","example":null},"storeDomain":{"type":"string","description":"Store domain","example":null},"storeLink":{"type":"string","description":"Store link","example":null},"country":{"type":"string","description":"Country","example":null},"createdTime":{"type":"string","description":"Creation time","example":null},"productNum":{"type":"string","description":"Product count","example":null},"categoryNum":{"type":"string","description":"Category count","example":null},"categories":{"type":"array","description":"Category list (elements contain id and name)","example":null},"monthlyVisit":{"type":"string","description":"Monthly visits (formatted)","example":null},"monthOrderNum":{"type":"string","description":"Monthly orders (formatted)","example":null},"fbFollowers":{"type":"string","description":"Facebook followers","example":null},"insFollowers":{"type":"string","description":"Instagram followers","example":null},"advertiseCount":{"type":"string","description":"Ad count","example":null},"adLink":{"type":"string","description":"Ad library link","example":null},"email":{"type":"string","description":"Contact email","example":null},"facebookUrl":{"type":"string","description":"Facebook page","example":"https://example.com/image.jpg"},"instagramUrl":{"type":"string","description":"Instagram page","example":"https://example.com/image.jpg"},"socialLinks":{"type":"object","description":"Social media links (Map)","example":null},"globalRank":{"type":"string","description":"Global rank","example":null},"logo":{"type":"string","description":"Store logo URL","example":null},"availableStatus":{"type":"string","description":"Whether active: 1=Active","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Columns for rendering","example":[]},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Title (Shopify Store Query)","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type: shopify","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Tool type: ehunt","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style: tableListWorkbenches","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"storeNum":1,"stores":[{"storeId":"example-id","shopId":"example-id","facebookUrl":"https://example.com/image.jpg","instagramUrl":"https://example.com/image.jpg"}],"columns":[]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"shopify-store-query","x-nexscope-mcp-tool-name":"nexscope_shopify_store_query","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/temu-category-search/run":{"post":{"tags":["Temu Marketplace Intelligence"],"summary":"Temu Category Search","description":"Search synced Temu category data in the local database by keyword to find category Chinese names, English names, and category IDs for use in product/store filtering. Triggered when users mention Temu categories, Temu category ID, Temu category tree, Temu backend categories, temu categories, syncTemuCategory (Temu category sync) followed by category queries, or Temu category search. Even if the user does not mention the tool name, this skill should be triggered whenever searching for category IDs by keyword in the locally synced Temu category database.","operationId":"runTemuCategorySearch","externalDocs":{"description":"Temu Category Search documentation","url":"https://www.nexscope.ai/api-docs/temu-category-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.temu-category-search.","properties":{"keyword":{"type":"string","description":"Keyword: matches against category Chinese name, English name, category ID (substring)","example":"home"},"page":{"type":"integer","description":"Page number (starting from 1)","example":1},"pageSize":{"type":"integer","description":"Results per page, max 200","example":10}},"required":["keyword"],"example":{"page":1,"keyword":"home","pageSize":10},"additionalProperties":true},"example":{"page":1,"keyword":"home","pageSize":10}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of results returned on this page","example":1},{"type":"null"}]},"categories":{"anyOf":[{"type":"array","description":"List of matching categories","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Category ID","example":"example-id"},"categoryId":{"type":"string","description":"Category ID (upstream category id)","example":"example-id"},"parentId":{"type":"string","description":"Parent category ID (empty string for top-level)","example":"example-id"},"level":{"type":"integer","description":"Category hierarchy level","example":1},"categoryName":{"type":"string","description":"Category name (Chinese)","example":null},"categoryNameEn":{"type":"string","description":"Category name (English)","example":null},"isDeleted":{"type":"integer","description":"Whether deleted: 0=Normal, 1=Deleted","example":1},"hasChildren":{"type":"boolean","description":"Whether has child categories","example":false}}}},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider title for the Temu category search; the documented upstream value is in Chinese.","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"categories":[{"id":"example-id","categoryId":"example-id","parentId":"example-id","level":1,"isDeleted":1,"hasChildren":false}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"temu-category-search","x-nexscope-mcp-tool-name":"nexscope_temu_category_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/temu-product-source-query/run":{"post":{"tags":["Temu Marketplace Intelligence"],"summary":"Temu Product Source Query","description":"Filter Temu products by multiple dimensions (keyword/product ID/store ID, front/backend categories, price, rating, reviews, total/weekly/daily sales, listing date, fully-managed/semi-managed, semi-managed regions, tags, etc.). Triggered when users mention Temu products, Temu product selection, Pinduoduo cross-border, Temu bestsellers, Temu semi-managed, fully-managed products, Temu product query, or temu items. Even if the user does not mention the tool name, this skill should be triggered whenever searching for products, viewing sales/ratings/prices, or filtering products on Temu.","operationId":"runTemuProductSourceQuery","externalDocs":{"description":"Temu Product Source Query documentation","url":"https://www.nexscope.ai/api-docs/temu-product-source-query"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.temu-product-source-query.","properties":{"searchKey":{"type":"string","description":"Keyword or product ID / store ID"},"categoryHome":{"type":"string","description":"Front-end category ID"},"categoryBackend":{"type":"string","description":"Back-end category ID"},"priceBegin":{"type":"number","description":"Price range start (USD), combined to form upstream price","example":1},"priceEnd":{"type":"number","description":"Price range end (USD)","example":1},"ratingBegin":{"type":"number","description":"Rating range start, combined to form upstream rating","example":1},"ratingEnd":{"type":"number","description":"Rating range end","example":1},"reviewsBegin":{"type":"integer","description":"Review count range start, combined to form reviews","example":1},"reviewsEnd":{"type":"integer","description":"Review count range end","example":1},"salesTotalBegin":{"type":"integer","description":"Total sales range start, combined to form sales_total","example":1},"salesTotalEnd":{"type":"integer","description":"Total sales range end","example":1},"salesWeeklyBegin":{"type":"integer","description":"Weekly sales range start, combined to form sales_weekly","example":1},"salesWeeklyEnd":{"type":"integer","description":"Weekly sales range end","example":1},"salesDailyBegin":{"type":"integer","description":"Daily sales range start, combined to form sales_daily","example":1},"salesDailyEnd":{"type":"integer","description":"Daily sales range end","example":1},"publishTimeBegin":{"type":"string","description":"Listing date range start, combined to form publish_time"},"publishTimeEnd":{"type":"string","description":"Listing date range end"},"soldOut":{"type":"integer","description":"Whether delisted: 0=Listed, 1=Delisted","example":1},"isLocal":{"type":"integer","description":"Whether semi-managed: 0=Fully managed, 1=Semi-managed","example":1},"region":{"type":"string","description":"Semi-managed regions, comma-separated","example":"US"},"tags":{"type":"string","description":"Product tags, comma-separated"},"customTags":{"type":"string","description":"Custom tags, comma-separated"},"sortBy":{"type":"string","description":"Sort field+direction: order_week-0 (weekly sales descending, default), price-0, order_total-0, rating-0, etc."},"page":{"type":"integer","description":"Page number (starting from 1)","example":1},"pageSize":{"type":"integer","description":"Results per page, max 100, recommended not to exceed 50","example":1},"keyword":{"type":"string"}},"example":{"page":1,"keyword":"phone case","pageSize":10},"additionalProperties":true},"example":{"page":1,"keyword":"phone case","pageSize":10}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of results returned on this page","example":1},{"type":"null"}]},"productNum":{"anyOf":[{"type":"integer","description":"Total number of matching products (upstream product_num)","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Temu product list","example":[],"items":{"type":"object","properties":{"productId":{"type":"string","description":"Product ID","example":"example-id"},"productName":{"type":"string","description":"Product name (English)","example":null},"productNameCn":{"type":"string","description":"Product name (Chinese)","example":null},"logoUrl":{"type":"string","description":"Main image URL","example":"https://example.com/image.jpg"},"price":{"type":"string","description":"Price","example":null},"orderTotal":{"type":"string","description":"Total sales","example":null},"orderWeek":{"type":"string","description":"Weekly sales","example":null},"orderDay":{"type":"string","description":"Daily sales","example":null},"orderMonth":{"type":"string","description":"Monthly sales","example":null},"rating":{"type":"string","description":"Rating","example":null},"reviewNum":{"type":"string","description":"Review count","example":null},"publishTime":{"type":"string","description":"Listing time","example":null},"soldOut":{"type":"string","description":"Whether delisted","example":null},"isLocal":{"type":"string","description":"Whether semi-managed: 0=Fully managed, 1=Semi-managed","example":null},"localRegion":{"type":"string","description":"Semi-managed region list","example":null},"storeId":{"type":"string","description":"Store ID","example":"example-id"},"tags":{"type":"string","description":"Tag list","example":null},"customTags":{"type":"string","description":"Custom tags","example":null},"categoryHome":{"type":"string","description":"Front-end category","example":null},"categoryBackend":{"type":"string","description":"Back-end category","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Columns for rendering","example":[]},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Title (Temu Product Query)","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type: temu","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Tool type: ehunt","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style: tableListWorkbenches","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"productNum":1,"products":[{"productId":"example-id","logoUrl":"https://example.com/image.jpg","storeId":"example-id"}],"columns":[]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"temu-product-source-query","x-nexscope-mcp-tool-name":"nexscope_temu_product_source_query","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/temu-store-source-query/run":{"post":{"tags":["Temu Marketplace Intelligence"],"summary":"Temu Store Source Query","description":"Filter Temu stores by multiple dimensions (store name/ID, country site, backend category, fully-managed/semi-managed, total/weekly/monthly sales and revenue, rating, reviews, followers, product count, store opening time, etc.). Trigger when users mention Temu store, Temu store analysis, Temu seller, Temu store ranking, Temu semi-managed store, Temu revenue, temu stores, Temu store query. Even if the user does not mention the tool name, trigger this skill whenever they are looking for stores on Temu, filtering store data, or analyzing store performance.","operationId":"runTemuStoreSourceQuery","externalDocs":{"description":"Temu Store Source Query documentation","url":"https://www.nexscope.ai/api-docs/temu-store-source-query"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.temu-store-source-query.","properties":{"searchKey":{"type":"string","description":"Store name or ID keyword"},"siteId":{"type":"string","description":"Country site ID, multiple separated by commas (e.g., 211=US, 76=UK)","example":"example-id"},"category":{"type":"string","description":"Backend category ID, multiple separated by commas"},"isLocal":{"type":"string","description":"Whether semi-managed: 0=fully managed, 1=semi-managed"},"orderTotalMin":{"type":"integer","description":"Total sales range (start)","example":1},"orderTotalMax":{"type":"integer","description":"Total sales range (end)","example":1},"orderWeekMin":{"type":"integer","description":"Weekly sales range (start)","example":1},"orderWeekMax":{"type":"integer","description":"Weekly sales range (end)","example":1},"orderMonthMin":{"type":"integer","description":"Monthly sales range (start)","example":1},"orderMonthMax":{"type":"integer","description":"Monthly sales range (end)","example":1},"totalRevenueMin":{"type":"number","description":"Total revenue range (USD, start)","example":1},"totalRevenueMax":{"type":"number","description":"Total revenue range (USD, end)","example":1},"weekRevenueMin":{"type":"number","description":"Weekly revenue range (USD, start)","example":1},"weekRevenueMax":{"type":"number","description":"Weekly revenue range (USD, end)","example":1},"monthRevenueMin":{"type":"number","description":"Monthly revenue range (USD, start)","example":1},"monthRevenueMax":{"type":"number","description":"Monthly revenue range (USD, end)","example":1},"ratingMin":{"type":"number","description":"Rating range (start)","example":1},"ratingMax":{"type":"number","description":"Rating range (end)","example":1},"reviewNumMin":{"type":"integer","description":"Review count range (start)","example":1},"reviewNumMax":{"type":"integer","description":"Review count range (end)","example":1},"followerNumMin":{"type":"integer","description":"Follower count range (start)","example":1},"followerNumMax":{"type":"integer","description":"Follower count range (end)","example":1},"productNumMin":{"type":"integer","description":"Product count range (start)","example":1},"productNumMax":{"type":"integer","description":"Product count range (end)","example":1},"listedTimeBegin":{"type":"string","description":"Store opening date range (start)"},"listedTimeEnd":{"type":"string","description":"Store opening date range (end)"},"sortBy":{"type":"string","description":"Sort field+direction: order_week_count-0 (weekly sales descending, default), order_count-0, total_revenue-0, rating-0"},"page":{"type":"integer","description":"Page number (starting from 1)","example":1},"pageSize":{"type":"integer","description":"Items per page, max 100","example":1},"keyword":{"type":"string"}},"example":{"page":1,"keyword":"phone case","pageSize":10},"additionalProperties":true},"example":{"page":1,"keyword":"phone case","pageSize":10}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records on this page","example":1},{"type":"null"}]},"storeNum":{"anyOf":[{"type":"integer","description":"Total number of stores matching criteria (upstream store_num)","example":1},{"type":"null"}]},"stores":{"anyOf":[{"type":"array","description":"Temu store list","example":[],"items":{"type":"object","properties":{"storeId":{"type":"string","description":"Store ID","example":"example-id"},"siteId":{"type":"string","description":"Country site ID","example":"example-id"},"storeName":{"type":"string","description":"Store name","example":null},"logoUrl":{"type":"string","description":"Store logo URL","example":"https://example.com/image.jpg"},"orderTotal":{"type":"string","description":"Total sales","example":null},"orderWeek":{"type":"string","description":"Weekly sales","example":null},"orderMonth":{"type":"string","description":"Monthly sales","example":null},"totalRevenue":{"type":"string","description":"Total revenue","example":null},"weekRevenue":{"type":"string","description":"Weekly revenue","example":null},"monthRevenue":{"type":"string","description":"Monthly revenue","example":null},"rating":{"type":"string","description":"Rating","example":null},"listedTime":{"type":"string","description":"Store opening time","example":null},"reviewNum":{"type":"string","description":"Review count","example":null},"followerNum":{"type":"string","description":"Follower count","example":null},"productNum":{"type":"string","description":"Product count","example":null},"categoriesCn":{"type":"string","description":"Chinese category list","example":null},"categories":{"type":"string","description":"English category list","example":null},"isLocal":{"type":"string","description":"Whether semi-managed: 0=fully managed, 1=semi-managed","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":[]},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Title (Temu Store Query)","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type: temu","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Tool type: ehunt","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style: tableListWorkbenches","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"storeNum":1,"stores":[{"storeId":"example-id","siteId":"example-id","logoUrl":"https://example.com/image.jpg"}],"columns":[]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"temu-store-source-query","x-nexscope-mcp-tool-name":"nexscope_temu_store_source_query","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/text-trademark-detector/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Text Trademark Detector","description":"Text trademark detection and infringement risk analysis for e-commerce product listings. Trigger when users mention trademark detection, trademark risk check, brand infringement screening, product title trademark scan, text trademark search, listing compliance check, intellectual property risk assessment, text trademark detection, trademark infringement, brand infringement screening, listing compliance, intellectual property risk, Ruiguan. Even if the user does not explicitly say \"trademark\", trigger this skill whenever their need involves checking whether product text (titles, descriptions, bullet points) contains potentially infringing trademarks.","operationId":"runTextTrademarkDetector","externalDocs":{"description":"Text Trademark Detector documentation","url":"https://www.nexscope.ai/api-docs/text-trademark-detector"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.text-trademark-detector.","properties":{"productTitle":{"type":"string","description":"Product title, used for trademark detection (max 1000 characters)","example":"MagSafe Phone Case for iPhone"},"regions":{"type":"string","description":"Country/region codes, multiple separated by commas. Supported values: US, EM, GB, DE, FR, IT, ES, AU, CA, MX, JP, CN, WO, TR, BX","example":"US"},"limit":{"type":"integer","description":"Limit on the number of returned results (default 100, max 500)","example":10},"productText":{"type":"string","description":"Other product text information, such as bullet points or product description (max 1000 characters)","example":"Protective magnetic phone case with shockproof corners."}},"required":["productTitle","limit"],"example":{"regions":"US","productText":"Protective magnetic phone case with shockproof corners.","limit":10,"productTitle":"MagSafe Phone Case for iPhone"},"additionalProperties":true},"example":{"regions":"US","productText":"Protective magnetic phone case with shockproof corners.","limit":10,"productTitle":"MagSafe Phone Case for iPhone"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of matched trademark records","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Trademark list (flattened), each element contains the following fields","example":[],"items":{"type":"object","properties":{"textTrademarkRadar":{"type":"string","description":"Product risk level: \"0\" = low risk, \"1\" = pending manual review, \"2\" = high risk","example":null},"trademarkName":{"type":"string","description":"Trademark word","example":null},"region":{"type":"string","description":"Country/region code","example":"US"},"score":{"type":"integer","description":"Risk score","example":1},"highestModeScore":{"type":"integer","description":"Highest risk score (range 0-5)","example":1},"trademarksStatus":{"type":"string","description":"Status of the highest-score trademark word","example":null},"regionStatus":{"type":"string","description":"Trademark status in the matched region","example":null},"holder":{"type":"string","description":"Rights holder","example":null},"applicationNumber":{"type":"string","description":"Application number","example":null},"registrationNumber":{"type":"string","description":"Registration number","example":null},"isFamous":{"type":"boolean","description":"Whether it is a famous trademark","example":false},"isAmazonBrand":{"type":"boolean","description":"Whether it is an Amazon hot search brand","example":false},"isActiveHolder":{"type":"boolean","description":"Whether the holder is an active enforcer","example":false},"isCompatibility":{"type":"boolean","description":"Whether it is compatibility","example":false},"isCommonSense":{"type":"boolean","description":"Whether it is a common word","example":false},"niceClass":{"type":"array","description":"Nice classification","example":[]},"originalTextMatches":{"type":"array","description":"Original matched trigger words","example":[]}}}},{"type":"null"}]},"detectId":{"anyOf":[{"type":"string","description":"API call ID","example":"example-id"},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered column definitions","example":[]},{"type":"null"}]},"blacklistTrademarks":{"anyOf":[{"type":"array","description":"Blacklisted trademarks detected in the text","example":[],"items":{"type":"object","properties":{"trademark":{"type":"string","description":"Trademark name","example":null},"region":{"type":"string","description":"Country/region code","example":"US"},"note":{"type":"string","description":"Remarks","example":null}}}},{"type":"null"}]},"whitelistTrademarks":{"anyOf":[{"type":"array","description":"Whitelisted (safe) trademarks detected in the text","example":[],"items":{"type":"object","properties":{"trademark":{"type":"string","description":"Trademark name","example":null},"region":{"type":"string","description":"Country/region code","example":"US"},"note":{"type":"string","description":"Remarks","example":null}}}},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"region":"US","score":1,"highestModeScore":1,"isFamous":false,"isAmazonBrand":false,"isActiveHolder":false,"isCompatibility":false,"isCommonSense":false,"niceClass":[],"originalTextMatches":[]}],"detectId":"example-id","columns":[],"blacklistTrademarks":[{"region":"US"}],"whitelistTrademarks":[{"region":"US"}],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"text-trademark-detector","x-nexscope-mcp-tool-name":"nexscope_text_trademark_detector","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-batch-product-detail/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"Tiktok Batch Product Detail","description":"Batch query TikTok product detail data, including multi-period sales and GMV (1d/7d/15d/30d/60d/90d/cumulative), live sales and live GMV, promoting video and creator data, views, price, rating, review count, commission rate, and delisted/fully-managed status. Supports batch retrieval by product ID or TikTok Shop product URL. Trigger when users mention TikTok product detail, batch query TikTok products, TikTok product sales analysis, TikTok product GMV, TikTok live sales, TikTok influencer sales data, TikTok product price rating, batch get TikTok product info, Nexscope product detail, TikTok product detail, batch product lookup, TikTok sales analysis, TikTok GMV, TikTok live sales, TikTok influencer data. Even if the user does not explicitly mention \"Nexscope\", trigger this skill whenever their need involves batch retrieval of detailed TikTok product sales and marketing data by product ID or product URL.","operationId":"runTiktokBatchProductDetail","externalDocs":{"description":"Tiktok Batch Product Detail documentation","url":"https://www.nexscope.ai/api-docs/tiktok-batch-product-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.tiktok-batch-product-detail.","properties":{"productIds":{"type":"array","items":{"type":"string"},"description":"List of product IDs (max 1000). Example: [\"1729382310407603945\", \"1729382310407603946\"]","example":["1732294342978343112"]},"productUrls":{"type":"array","items":{},"description":"List of product URLs (max 1000), in the form https://shop.tiktok.com/us/pdp/<slug>/<productId>?...; the backend will extract the trailing productId from each URL and merge into productIds, not mutually exclusive with productIds","example":[]}},"example":{"productIds":["1732294342978343112"]},"additionalProperties":true},"example":{"productIds":["1732294342978343112"]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Record count","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product detail list (see product object below)","example":[],"items":{"type":"object","properties":{"productId":{"type":"string","description":"Product ID","example":"example-id"},"productName":{"type":"string","description":"Product name","example":null},"imageUrl":{"type":"string","description":"Product image","example":"https://example.com/image.jpg"},"productImageUrls":{"type":"array","description":"Product image URL list","example":[]},"region":{"type":"string","description":"Region code","example":"US"},"sellerId":{"type":"string","description":"Seller ID","example":"example-id"},"categoryId":{"type":"string","description":"Primary category ID","example":"example-id"},"categoryL2Id":{"type":"string","description":"Secondary category ID","example":"example-id"},"categoryL3Id":{"type":"string","description":"Tertiary category ID","example":"example-id"},"minPrice":{"type":"number","description":"Minimum SKU price (USD)","example":1},"maxPrice":{"type":"number","description":"Maximum SKU price (USD)","example":1},"spuAvgPrice":{"type":"number","description":"SPU average price (USD)","example":1},"productRating":{"type":"number","description":"Product rating","example":1},"reviewCount":{"type":"integer","description":"Review count","example":1},"productCommissionRate":{"type":"number","description":"Product commission rate","example":1},"totalSaleCnt":{"type":"integer","description":"Total sales","example":1},"totalSale1dCnt":{"type":"integer","description":"Sales in last 1 day","example":1},"totalSale7dCnt":{"type":"integer","description":"Sales in last 7 days","example":1},"totalSale15dCnt":{"type":"integer","description":"Sales in last 15 days","example":1},"totalSale30dCnt":{"type":"integer","description":"Sales in last 30 days","example":1},"totalSale60dCnt":{"type":"integer","description":"Sales in last 60 days","example":1},"totalSale90dCnt":{"type":"integer","description":"Sales in last 90 days","example":1},"totalSaleGmvAmt":{"type":"number","description":"Total GMV","example":1},"totalSaleGmv1dAmt":{"type":"number","description":"GMV in last 1 day","example":1},"totalSaleGmv7dAmt":{"type":"number","description":"GMV in last 7 days","example":1},"totalSaleGmv15dAmt":{"type":"number","description":"GMV in last 15 days","example":1},"totalSaleGmv30dAmt":{"type":"number","description":"GMV in last 30 days","example":1},"totalSaleGmv60dAmt":{"type":"number","description":"GMV in last 60 days","example":1},"totalSaleGmv90dAmt":{"type":"number","description":"GMV in last 90 days","example":1},"totalLiveCnt":{"type":"integer","description":"Total livestream count","example":1},"totalLive1dCnt":{"type":"integer","description":"Livestream count in last 1 day","example":1},"totalLive7dCnt":{"type":"integer","description":"Livestream count in last 7 days","example":1},"totalLive15dCnt":{"type":"integer","description":"Livestream count in last 15 days","example":1},"totalLive30dCnt":{"type":"integer","description":"Livestream count in last 30 days","example":1},"totalLive60dCnt":{"type":"integer","description":"Livestream count in last 60 days","example":1},"totalLive90dCnt":{"type":"integer","description":"Livestream count in last 90 days","example":1},"totalLiveSale1dCnt":{"type":"integer","description":"Livestream sales in last 1 day","example":1},"totalLiveSale7dCnt":{"type":"integer","description":"Livestream sales in last 7 days","example":1},"totalLiveSale15dCnt":{"type":"integer","description":"Livestream sales in last 15 days","example":1},"totalLiveSale30dCnt":{"type":"integer","description":"Livestream sales in last 30 days","example":1},"totalLiveSale60dCnt":{"type":"integer","description":"Livestream sales in last 60 days","example":1},"totalLiveSale90dCnt":{"type":"integer","description":"Livestream sales in last 90 days","example":1},"totalLiveSaleGmv1dAmt":{"type":"integer","description":"Livestream GMV in last 1 day","example":1},"totalLiveSaleGmv7dAmt":{"type":"integer","description":"Livestream GMV in last 7 days","example":1},"totalLiveSaleGmv15dAmt":{"type":"integer","description":"Livestream GMV in last 15 days","example":1},"totalLiveSaleGmv30dAmt":{"type":"integer","description":"Livestream GMV in last 30 days","example":1},"totalLiveSaleGmv60dAmt":{"type":"integer","description":"Livestream GMV in last 60 days","example":1},"totalLiveSaleGmv90dAmt":{"type":"integer","description":"Livestream GMV in last 90 days","example":1},"totalVideoCnt":{"type":"integer","description":"Total video count","example":1},"totalVideo1dCnt":{"type":"integer","description":"Video count in last 1 day","example":1},"totalVideo7dCnt":{"type":"integer","description":"Video count in last 7 days","example":1},"totalVideo15dCnt":{"type":"integer","description":"Video count in last 15 days","example":1},"totalVideo30dCnt":{"type":"integer","description":"Video count in last 30 days","example":1},"totalVideo60dCnt":{"type":"integer","description":"Video count in last 60 days","example":1},"totalVideo90dCnt":{"type":"integer","description":"Video count in last 90 days","example":1},"totalIflCnt":{"type":"integer","description":"Total creator count","example":1},"totalIflVideo1dCnt":{"type":"integer","description":"Creator video count in last 1 day","example":1},"totalIflVideo7dCnt":{"type":"integer","description":"Creator video count in last 7 days","example":1},"totalIflVideo15dCnt":{"type":"integer","description":"Creator video count in last 15 days","example":1},"totalIflVideo30dCnt":{"type":"integer","description":"Creator video count in last 30 days","example":1},"totalIflVideo60dCnt":{"type":"integer","description":"Creator video count in last 60 days","example":1},"totalIflVideo90dCnt":{"type":"integer","description":"Creator video count in last 90 days","example":1},"totalIflLive1dCnt":{"type":"integer","description":"Creator livestream count in last 1 day","example":1},"totalIflLive7dCnt":{"type":"integer","description":"Creator livestream count in last 7 days","example":1},"totalIflLive15dCnt":{"type":"integer","description":"Creator livestream count in last 15 days","example":1},"totalIflLive30dCnt":{"type":"integer","description":"Creator livestream count in last 30 days","example":1},"totalIflLive60dCnt":{"type":"integer","description":"Creator livestream count in last 60 days","example":1},"totalIflLive90dCnt":{"type":"integer","description":"Creator livestream count in last 90 days","example":1},"totalViewsCnt":{"type":"integer","description":"Total view count","example":1},"totalViews1dCnt":{"type":"integer","description":"Views in last 1 day","example":1},"totalViews7dCnt":{"type":"integer","description":"Views in last 7 days","example":1},"totalViews15dCnt":{"type":"integer","description":"Views in last 15 days","example":1},"totalViews30dCnt":{"type":"integer","description":"Views in last 30 days","example":1},"totalViews60dCnt":{"type":"integer","description":"Views in last 60 days","example":1},"totalViews90dCnt":{"type":"integer","description":"Views in last 90 days","example":1},"discount":{"type":"string","description":"Discount info","example":null},"freeShipping":{"type":"integer","description":"Whether free shipping","example":1},"salesFlag":{"type":"integer","description":"Primary shipping method","example":1},"salesTrendFlag":{"type":"integer","description":"Sales trend indicator: 0=stable, 1=rising, 2=falling","example":1},"isSShop":{"type":"integer","description":"Whether fully managed store","example":1},"offMark":{"type":"integer","description":"Product delisting indicator","example":1},"firstCrawlDt":{"type":"string","description":"First crawl date","example":null},"descDetail":{"type":"string","description":"Product detail description","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"productId":"example-id","imageUrl":"https://example.com/image.jpg","productImageUrls":[],"region":"US","sellerId":"example-id","categoryId":"example-id","categoryL2Id":"example-id","categoryL3Id":"example-id","minPrice":1,"maxPrice":1,"spuAvgPrice":1,"productRating":1,"reviewCount":1,"productCommissionRate":1,"totalSaleCnt":1,"totalSale1dCnt":1,"totalSale7dCnt":1,"totalSale15dCnt":1,"totalSale30dCnt":1,"totalSale60dCnt":1,"totalSale90dCnt":1,"totalSaleGmvAmt":1,"totalSaleGmv1dAmt":1,"totalSaleGmv7dAmt":1,"totalSaleGmv15dAmt":1,"totalSaleGmv30dAmt":1,"totalSaleGmv60dAmt":1,"totalSaleGmv90dAmt":1,"totalLiveCnt":1,"totalLive1dCnt":1,"totalLive7dCnt":1,"totalLive15dCnt":1,"totalLive30dCnt":1,"totalLive60dCnt":1,"totalLive90dCnt":1,"totalLiveSale1dCnt":1,"totalLiveSale7dCnt":1,"totalLiveSale15dCnt":1,"totalLiveSale30dCnt":1,"totalLiveSale60dCnt":1,"totalLiveSale90dCnt":1,"totalLiveSaleGmv1dAmt":1,"totalLiveSaleGmv7dAmt":1,"totalLiveSaleGmv15dAmt":1,"totalLiveSaleGmv30dAmt":1,"totalLiveSaleGmv60dAmt":1,"totalLiveSaleGmv90dAmt":1,"totalVideoCnt":1,"totalVideo1dCnt":1,"totalVideo7dCnt":1,"totalVideo15dCnt":1,"totalVideo30dCnt":1,"totalVideo60dCnt":1,"totalVideo90dCnt":1,"totalIflCnt":1,"totalIflVideo1dCnt":1,"totalIflVideo7dCnt":1,"totalIflVideo15dCnt":1,"totalIflVideo30dCnt":1,"totalIflVideo60dCnt":1,"totalIflVideo90dCnt":1,"totalIflLive1dCnt":1,"totalIflLive7dCnt":1,"totalIflLive15dCnt":1,"totalIflLive30dCnt":1,"totalIflLive60dCnt":1,"totalIflLive90dCnt":1,"totalViewsCnt":1,"totalViews1dCnt":1,"totalViews7dCnt":1,"totalViews15dCnt":1,"totalViews30dCnt":1,"totalViews60dCnt":1,"totalViews90dCnt":1,"freeShipping":1,"salesFlag":1,"salesTrendFlag":1,"isSShop":1,"offMark":1}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-batch-product-detail","x-nexscope-mcp-tool-name":"nexscope_tiktok_batch_product_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-creator-analytics/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"Tiktok Creator Analytics","description":"Search TikTok e-commerce creator leaderboards via Kalodata and query detailed profiles for specific creators. Supports viewing top-performing influencer-sellers by region, currency, language, and date range, and using creatorId to retrieve follower count, video/live revenue and GPM, contact information, and associated shops. Trigger when users mention TikTok creator search, TikTok creator ranking, TikTok influencer leaderboard, TikTok creator detail, TikTok creator profile, creator homepage data, creator contact info, TikTok creator search, TikTok creator ranking, TikTok influencer leaderboard, TikTok creator detail, creator analytics, kalodata creator search/detail. Even if the user does not explicitly mention \"kalodata\", trigger this skill whenever their need involves viewing TikTok creator leaderboards or detailed sales performance data for a specific TikTok creator.","operationId":"runTiktokCreatorAnalytics","externalDocs":{"description":"Tiktok Creator Analytics documentation","url":"https://www.nexscope.ai/api-docs/tiktok-creator-analytics"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string","description":"Region/market code, e.g., US","example":"US"},"dateRange":{"type":"string","description":"Time range, e.g., last7Day, last30Day","example":"last30Day"},"pageNumber":{"type":"integer","description":"Rank requests only: page number 1-5; detail requests are unaffected. Finite numeric strings and optional null remain accepted for compatibility.","example":1},"pageSize":{"type":"integer","description":"Rank requests only: items per page 5-100; detail requests are unaffected. Finite numeric strings and optional null remain accepted for compatibility.","example":10},"language":{"type":"string","description":"Return language, e.g., zh-CN, en-US","example":null},"currency":{"type":"string","description":"Currency unit, e.g., USD","example":null},"sortField":{"type":"object","description":"Sort criteria; pass an empty object {} for default rank order when not sorting","example":{}},"category_ids":{"type":"array","description":"Category ID list filter","example":[]},"shop_id":{"type":"string","description":"Shop ID filter","example":null},"revenue_range":{"type":"string","description":"Revenue / GMV range filter","example":null},"creator_type":{"type":"string","description":"Creator type filter","example":null},"followers_range":{"type":"string","description":"Follower range filter","example":null},"engagement_rate":{"type":"string","description":"Engagement-rate filter","example":null},"creatorId":{"type":"string","description":"Creator unique ID, e.g., 7153432386608251946, obtainable from the creator_id in the creator rank response","example":"68616495085350913"}},"required":[],"additionalProperties":true},"example":{"sortField":{},"dateRange":"last30Day","pageSize":10,"pageNumber":1,"region":"US","creatorId":"68616495085350913"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"array","description":"Rank or detail data","example":[],"items":{"type":"object","properties":{"creator_nickname":{"type":"string","description":"Creator nickname","example":null},"creator_handle":{"type":"string","description":"TikTok profile name, e.g., @based","example":null},"creator_id":{"type":"string","description":"Creator unique ID, string format to avoid large integer precision loss","example":"example-id"},"creator_followers":{"type":"string","description":"Follower count, returned as string","example":null},"content_views":{"type":"string","description":"Total content views, returned as string","example":null},"sales_volumn":{"type":"integer","description":"Sales volume, field spelled as volumn","example":1},"revenue":{"type":"number","description":"Total revenue / GMV, returned in the requested currency","example":1},"video_revenue":{"type":"number","description":"Short video sales revenue","example":1},"live_revenue":{"type":"number","description":"Livestream sales revenue","example":1},"revenue_growth_rate":{"type":"number","description":"Revenue growth rate (%), can be positive or negative","example":1},"creator_region":{"type":"string","description":"Creator region","example":null},"creator_status":{"type":"string","description":"Creator status","example":null},"creator_bio":{"type":"string","description":"Creator bio","example":null},"creator_belonged_shop_id":{"type":"string","description":"Belonged shop ID","example":"example-id"},"new_followers":{"type":"integer","description":"New followers within the dateRange window","example":1},"unit_price":{"type":"number","description":"Unit price","example":1},"video_number":{"type":"integer","description":"Video count within the window","example":1},"video_views":{"type":"integer","description":"Total video views","example":1},"video_gpm":{"type":"number","description":"Video GPM","example":1},"live_number":{"type":"integer","description":"Livestream count within the window","example":1},"live_views":{"type":"integer","description":"Total livestream views","example":1},"live_gpm":{"type":"number","description":"Livestream GPM","example":1},"product_number":{"type":"integer","description":"Associated product count","example":1},"shop_number":{"type":"integer","description":"Associated shop count","example":1},"creator_contact_email":{"type":"string","description":"Contact email","example":null},"creator_contact_ins":{"type":"string","description":"Instagram contact","example":null},"creator_contact_whatsapp":{"type":"string","description":"WhatsApp contact","example":null},"creator_contact_facebook":{"type":"string","description":"Facebook contact","example":null},"creator_contact_tiktok":{"type":"string","description":"TikTok contact","example":null},"creator_contact_zalo":{"type":"string","description":"Zalo contact","example":null},"creator_contact_line":{"type":"string","description":"Line contact","example":null}}}},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed for this call, typically 14000","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":[{"creator_id":"example-id","sales_volumn":1,"revenue":1,"video_revenue":1,"live_revenue":1,"revenue_growth_rate":1,"creator_belonged_shop_id":"example-id","new_followers":1,"unit_price":1,"video_number":1,"video_views":1,"video_gpm":1,"live_number":1,"live_views":1,"live_gpm":1,"product_number":1,"shop_number":1}],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-creator-analytics","x-nexscope-mcp-tool-name":"nexscope_tiktok_creator_analytics","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-creator-search/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Creator Rankings","description":"Queries creator rankings by region and date range.","operationId":"runTiktokCreatorSearch","externalDocs":{"description":"TikTok Creator Search documentation","url":"https://www.nexscope.ai/api-docs/tiktok-creator-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string","description":"Optional TikTok Shop market region.","example":"US"},"dateRange":{"type":"string","description":"Relative date range.","example":"last30Day"},"pageNumber":{"type":"integer","description":"Page number, 1-5. Finite numeric strings and optional null remain accepted by the backend for compatibility.","example":1,"minimum":1,"maximum":5,"x-nexscope-constraints":{"minimum":1,"maximum":5}},"pageSize":{"type":"integer","description":"Rows per page, 5-100. Finite numeric strings and optional null remain accepted by the backend for compatibility.","example":10,"minimum":5,"maximum":100,"x-nexscope-constraints":{"minimum":5,"maximum":100}},"currency":{"type":"string","description":"Currency code.","example":"USD"},"language":{"type":"string","description":"Response language.","example":"en-US"},"sortField":{"type":"object","description":"Optional provider sort object.","example":{}}},"required":[],"additionalProperties":true},"example":{"dateRange":"last30Day","region":"US","pageSize":10,"pageNumber":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"array","description":"Creator ranking rows.","example":[],"items":{"type":"object","properties":{"creator_id":{"type":"string","description":"TikTok creator ID.","example":"68616495085350913"},"creator_nickname":{"type":"string","description":"Creator nickname.","example":"Example creator"},"creator_handle":{"type":"string","description":"TikTok handle.","example":"@creator"},"creator_followers":{"type":"string","description":"Follower count returned as a string.","example":"100000"},"content_views":{"type":"string","description":"Content views returned as a string.","example":"1000000"},"sales_volumn":{"type":"integer","description":"Estimated sales volume (provider spelling).","example":100},"revenue":{"type":"number","description":"Estimated creator GMV.","example":1000},"video_revenue":{"type":"number","description":"Short-video revenue.","example":600},"live_revenue":{"type":"number","description":"Livestream revenue.","example":400},"revenue_growth_rate":{"type":"number","description":"Revenue growth percentage.","example":12.5},"creator_region":{"type":"string","description":"Creator region.","example":"US"},"creator_status":{"type":"string","description":"Creator status.","example":"active"},"new_followers":{"type":"integer","description":"New followers in the selected window.","example":1000},"video_number":{"type":"integer","description":"Video count.","example":20},"live_number":{"type":"integer","description":"Livestream count.","example":5},"product_number":{"type":"integer","description":"Associated product count.","example":10},"shop_number":{"type":"integer","description":"Associated shop count.","example":3}}}},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":[{"creator_id":"68616495085350913","creator_nickname":"Example creator","creator_handle":"@creator","creator_followers":"100000","content_views":"1000000","sales_volumn":100,"revenue":1000,"video_revenue":600,"live_revenue":400,"revenue_growth_rate":12.5,"creator_region":"US","creator_status":"active","new_followers":1000,"video_number":20,"live_number":5,"product_number":10,"shop_number":3}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-creator-search","x-nexscope-mcp-tool-name":"nexscope_tiktok_creator_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-livestream-analytics/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"Tiktok Livestream Analytics","description":"Search TikTok e-commerce livestream leaderboards via Kalodata and query detailed data for specific livestreams. Supports viewing high-ranking, high-sales TikTok shopping livestreams by region, currency, language, and date range, and using livestreamId to retrieve revenue, viewers, duration, GPM, and number of products sold. Trigger when users mention TikTok livestream ranking, TikTok live ranking, TikTok top livestreams, TikTok live shopping ranking, TikTok livestream detail, TikTok live data, live viewers, kalodata livestream search, kalodata livestream ranking, TikTok livestream ranking, TikTok live ranking, TikTok top livestreams, TikTok live shopping ranking, TikTok livestream detail, kalodata livestream search/detail, live analytics. Even if the user does not explicitly mention \"kalodata\", trigger this skill whenever their need involves viewing TikTok livestream leaderboards or detailed data for a specific TikTok livestream.","operationId":"runTiktokLivestreamAnalytics","externalDocs":{"description":"Tiktok Livestream Analytics documentation","url":"https://www.nexscope.ai/api-docs/tiktok-livestream-analytics"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.tiktok-livestream-analytics.","properties":{"region":{"type":"string","description":"Region/market code, e.g., US. Max length 1000","example":"US"},"dateRange":{"type":"string","description":"Time range, e.g., last7Day (last 7 days), last30Day (last 30 days). Max length 1000","example":"last30Day"},"pageNumber":{"type":"integer","description":"Page number, value range 1-5 (out of range returns errcode 501)","example":1},"pageSize":{"type":"integer","description":"Items per page, value range 5-100","example":10},"language":{"type":"string","description":"Return language, e.g., zh-CN, en-US. Max length 1000"},"currency":{"type":"string","description":"Currency unit, e.g., USD. Max length 1000"},"sortField":{"type":"object","description":"Sort criteria, structure defined by the gateway; pass an empty object {} for default rank order when not sorting","example":{},"properties":{},"additionalProperties":true},"livestreamId":{"type":"string","description":"Target livestream unique ID (camelCase), e.g., 7661409374878878494. Typically obtained from the livestream_id in the livestream rank endpoint. Max length 1000"},"category_id":{"type":"string","description":"Category ID filter"},"shop_id":{"type":"string","description":"Shop ID filter"},"creator_id":{"type":"string","description":"Creator ID filter"},"product_id":{"type":"string","description":"Product ID filter"},"followers_range":{"type":"string","description":"Creator follower range filter"}},"example":{"pageNumber":1,"sortField":{},"region":"US","pageSize":10,"dateRange":"last30Day"},"additionalProperties":true},"example":{"pageNumber":1,"sortField":{},"region":"US","pageSize":10,"dateRange":"last30Day"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"array","description":"Livestream rank list or livestream detail data","example":[],"items":{"type":"object","properties":{"livestream_start_time":{"type":"integer","description":"Livestream start time (epoch milliseconds)","example":1},"livestream_end_time":{"type":"integer","description":"Livestream end time (epoch milliseconds)","example":1},"livestream_duration":{"type":"integer","description":"Livestream duration (seconds)","example":1},"livestream_title":{"type":"string","description":"Livestream title","example":null},"livestream_id":{"type":"string","description":"Livestream unique ID (string, to avoid large integer precision loss); can be used as livestreamId in the detail endpoint","example":"example-id"},"creator_id":{"type":"string","description":"Creator unique ID (string, to avoid large integer precision loss)","example":"example-id"},"creator_handle":{"type":"string","description":"Creator account handle","example":null},"revenue":{"type":"string","description":"Total revenue / GMV (in the requested currency; returned as string, e.g., \"185590.52\")","example":null},"unit_price":{"type":"string","description":"Unit price (in the requested currency; returned as string, e.g., \"265.89\")","example":null},"views":{"type":"integer","description":"View count","example":1},"record_type":{"type":"string","description":"Record type (e.g., SHORT)","example":null},"viewers":{"type":"integer","description":"Viewer count (note: DETAIL uses viewers, RANK uses views)","example":1},"gpm":{"type":"number","description":"GMV per mille, number type -- unique to DETAIL, not present in the RANK endpoint","example":1},"product_number":{"type":"integer","description":"Product count in the livestream","example":1}}}},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed for this call, fixed at 14000","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":[{"livestream_start_time":1,"livestream_end_time":1,"livestream_duration":1,"livestream_id":"example-id","creator_id":"example-id","views":1,"viewers":1,"gpm":1,"product_number":1}],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-livestream-analytics","x-nexscope-mcp-tool-name":"nexscope_tiktok_livestream_analytics","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-new-product-rank/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"Tiktok New Product Rank","description":"Discover trending new products across 16 TikTok Shop regional markets via Nexscope new product ranking data. Trigger when users mention TikTok new product rankings, TikTok hot-selling products, TikTok Shop bestsellers, short-video e-commerce product selection, TikTok new product discovery, cross-border TikTok product selection, TikTok new product rankings, TikTok bestsellers, short-video product selection, TikTok viral products, new product ranking, TikTok product trends. Even if the user does not explicitly mention \"Nexscope\" or \"new product ranking\", trigger this skill whenever their need involves discovering hot-selling new products or emerging product trends on TikTok Shop.","operationId":"runTiktokNewProductRank","externalDocs":{"description":"Tiktok New Product Rank documentation","url":"https://www.nexscope.ai/api-docs/tiktok-new-product-rank"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.tiktok-new-product-rank.","properties":{"date":{"type":"string","description":"Date in YYYY-MM-DD format","example":"2026-08-01"},"region":{"type":"string","description":"Region, default US. Options: US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (United Kingdom), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France)","example":"US"},"pageNum":{"type":"integer","description":"Page number, default 1","example":1},"pageSize":{"type":"integer","description":"Items per page, default 50","example":10}},"required":["date"],"example":{"pageNum":1,"date":"2026-08-01","region":"US","pageSize":10},"additionalProperties":true},"example":{"pageNum":1,"date":"2026-08-01","region":"US","pageSize":10}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Record count","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"New product list (see product object below)","example":[],"items":{"type":"object","properties":{"title":{"type":"string","description":"Product name","example":null},"asin":{"type":"string","description":"Product ID","example":"B072MQ5BRX"},"region":{"type":"string","description":"Region code","example":"US"},"price":{"type":"number","description":"SPU average price","example":1},"minPrice":{"type":"number","description":"Minimum price","example":1},"maxPrice":{"type":"number","description":"Maximum price","example":1},"currency":{"type":"string","description":"Currency","example":null},"totalSaleCnt":{"type":"integer","description":"Total sales","example":1},"totalSale30dCnt":{"type":"integer","description":"Sales in last 30 days","example":1},"totalSaleGmvAmt":{"type":"number","description":"Total GMV","example":1},"totalSaleGmv30dAmt":{"type":"number","description":"GMV in last 30 days","example":1},"salesTrendFlagText":{"type":"string","description":"Sales trend indicator, 0=stable 1=rising 2=falling","example":null},"totalVideoCnt":{"type":"integer","description":"Total video count","example":1},"totalLiveCnt":{"type":"integer","description":"Total livestream count","example":1},"totalIflCnt":{"type":"integer","description":"Total creator count","example":1},"productCommissionRate":{"type":"number","description":"Product commission rate","example":1},"productRating":{"type":"number","description":"Product rating","example":1},"reviewCount":{"type":"integer","description":"Review count","example":1},"availableDate":{"type":"string","description":"First crawl date","example":"2026-01-01"},"categoryId":{"type":"string","description":"Product category ID","example":"example-id"},"imageUrl":{"type":"string","description":"Product image","example":"https://example.com/image.jpg"},"productImageUrls":{"type":"array","description":"Product image URL list","example":[]},"sourceTool":{"type":"string","description":"Source tool","example":null},"sourceType":{"type":"string","description":"Product source","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"asin":"B072MQ5BRX","region":"US","price":1,"minPrice":1,"maxPrice":1,"totalSaleCnt":1,"totalSale30dCnt":1,"totalSaleGmvAmt":1,"totalSaleGmv30dAmt":1,"totalVideoCnt":1,"totalLiveCnt":1,"totalIflCnt":1,"productCommissionRate":1,"productRating":1,"reviewCount":1,"availableDate":"2026-01-01","categoryId":"example-id","imageUrl":"https://example.com/image.jpg","productImageUrls":[]}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-new-product-rank","x-nexscope-mcp-tool-name":"nexscope_tiktok_new_product_rank","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-product-analytics/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"Tiktok Product Analytics","description":"Query TikTok e-commerce product leaderboards via Kalodata and query detailed data for specific products. Supports viewing high-ranking/hot-selling products by region, currency, language, and date range, and using productId to retrieve price range, sales, revenue, commission rate, listing/delisting time, and owning shop. Trigger when users mention TikTok product ranking, TikTok bestseller chart, TikTok top products, kalodata product rank, TikTok product detail, TikTok product profile, product price, product sales, TikTok product ranking, TikTok bestseller chart, TikTok top products, kalodata product rank, TikTok product detail, kalodata product detail, product analytics. Even if the user does not explicitly mention \"kalodata\", trigger this skill whenever their need involves viewing TikTok product leaderboards or detailed data for a specific TikTok product.","operationId":"runTiktokProductAnalytics","externalDocs":{"description":"Tiktok Product Analytics documentation","url":"https://www.nexscope.ai/api-docs/tiktok-product-analytics"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.tiktok-product-analytics.","properties":{"region":{"type":"string","description":"TikTok Shop market region code, e.g., US. If not specified, defaults to the server default (usually US)","example":"US"},"dateRange":{"type":"string","description":"Relative date range, e.g., last7Day, last30Day","example":"last30Day"},"currency":{"type":"string","description":"Currency code, e.g., USD"},"language":{"type":"string","description":"Return language, e.g., zh-CN, en-US"},"sortField":{"type":"object","description":"Sort specification object; omitted to use default ranking","example":{},"properties":{},"additionalProperties":true},"pageNumber":{"type":"integer","description":"Page number, range 1-5","example":1},"pageSize":{"type":"integer","description":"Items per page, range 5-100","example":10},"productId":{"type":"string","description":"TikTok product ID, e.g., 1729508370969629931 (string format, to avoid large integer precision loss), obtainable from the product_id in the product rank response","example":"1732505564636812173"},"category_ids":{"type":"array","description":"Category ID list filter","example":[]},"shop_id":{"type":"string","description":"Shop ID filter"},"creator_id":{"type":"string","description":"Creator ID filter"},"video_id":{"type":"string","description":"Return products associated with the specified video"},"livestream_id":{"type":"string","description":"Return products associated with the specified livestream"},"revenue_range":{"type":"string","description":"Revenue / GMV range filter"},"is_affiliate":{"type":"string","description":"Affiliate filter: PUBLIC_PLAN or NON_AFFILIATE"},"commission_rate":{"type":"number","description":"Affiliate commission rate, e.g. 0.15"},"is_tts_product":{"type":"integer","description":"Fully managed product filter: 1 or 0"},"unit_price_range":{"type":"string","description":"Product unit-price range filter"}},"example":{"sortField":{},"dateRange":"last30Day","pageSize":10,"productId":"1732505564636812173","pageNumber":1,"region":"US"},"additionalProperties":true},"example":{"sortField":{},"dateRange":"last30Day","pageSize":10,"productId":"1732505564636812173","pageNumber":1,"region":"US"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"array","description":"Rank or detail data","example":[],"items":{"type":"object","properties":{"product_id":{"type":"string","description":"Product ID (string format, to avoid large integer precision loss); used as productId to query details","example":"example-id"},"product_name":{"type":"string","description":"Product title","example":null},"unit_price":{"type":"number","description":"Unit price (currency depends on region, e.g., US means USD)","example":1},"sales_volumn":{"type":"integer","description":"Sales volume (units). Note: the field name is spelled sales_volumn (as-is, not volume). Use this exact name when extracting with jq/ConvertFrom-Json","example":1},"revenue":{"type":"number","description":"Total revenue (GMV), = video_revenue + live_revenue + showcase_revenue","example":1},"video_revenue":{"type":"number","description":"Video channel revenue","example":1},"live_revenue":{"type":"number","description":"Livestream channel revenue","example":1},"showcase_revenue":{"type":"number","description":"Showcase/display channel revenue","example":1},"revenue_growth_rate":{"type":"number","description":"Revenue growth rate (percentage, e.g., 27.94 means 27.94%)","example":1},"commission_rate":{"type":"number","description":"Commission rate (percentage, e.g., 25.0 means 25%; not basis points)","example":1},"launch_date":{"type":"string","description":"Launch date (YYYY-MM-DD)","example":"2026-01-01"},"product_region":{"type":"string","description":"Product region/market (e.g., us)","example":null},"product_shop_id":{"type":"string","description":"Belonged shop ID","example":"example-id"},"pri_cate_id":{"type":"string","description":"Primary category ID","example":"example-id"},"sec_cate_id":{"type":"string","description":"Secondary category ID","example":"example-id"},"ter_cate_id":{"type":"string","description":"Tertiary category ID","example":"example-id"},"min_price":{"type":"number","description":"Minimum price (in the requested currency)","example":1},"max_price":{"type":"number","description":"Maximum price (in the requested currency)","example":1},"product_review_count":{"type":"integer","description":"Product review count","example":1},"delivery_type":{"type":"string","description":"Delivery method (e.g., local)","example":null},"video_number":{"type":"integer","description":"Associated video count","example":1},"live_number":{"type":"integer","description":"Associated livestream count","example":1},"shopping_mall_revenue":{"type":"number","description":"Mall revenue (in the requested currency)","example":1},"creator_number":{"type":"integer","description":"Associated creator count","example":1}}}},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed for this call, typically 14000","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":[{"product_id":"example-id","unit_price":1,"sales_volumn":1,"revenue":1,"video_revenue":1,"live_revenue":1,"showcase_revenue":1,"revenue_growth_rate":1,"commission_rate":1,"launch_date":"2026-01-01","product_shop_id":"example-id","pri_cate_id":"example-id","sec_cate_id":"example-id","ter_cate_id":"example-id","min_price":1,"max_price":1,"product_review_count":1,"video_number":1,"live_number":1,"shopping_mall_revenue":1,"creator_number":1}],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-product-analytics","x-nexscope-mcp-tool-name":"nexscope_tiktok_product_analytics","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-product-analytics-api/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Product Analytics API","description":"Queries Kalodata product details, including price, sales, revenue, commission, lifecycle, and shop data.","operationId":"runTiktokProductAnalyticsApi","externalDocs":{"description":"TikTok Product Analytics API documentation","url":"https://www.nexscope.ai/api-docs/tiktok-product-analytics-api"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Kalodata product-detail query.","properties":{"productId":{"type":"string","description":"TikTok product ID.","example":"1732505564636812173"},"region":{"type":"string","description":"TikTok Shop market region.","example":"US"},"currency":{"type":"string","description":"Currency code.","example":"USD"},"language":{"type":"string","description":"Response language.","example":"en-US"}},"required":["productId"],"example":{"productId":"1732505564636812173","region":"US"},"additionalProperties":true},"example":{"productId":"1732505564636812173","region":"US"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"array","description":"Product-detail data.","example":[],"items":{"type":"object","properties":{"product_id":{"type":"string","description":"TikTok product ID.","example":"1732505564636812173"},"product_name":{"type":"string","description":"Product name.","example":"Example product"},"unit_price":{"type":"number","description":"Current unit price.","example":12.99},"sales_volumn":{"type":"integer","description":"Estimated sales volume (provider spelling).","example":100},"revenue":{"type":"number","description":"Total revenue / GMV.","example":1000},"video_revenue":{"type":"number","description":"Video-channel revenue.","example":600},"live_revenue":{"type":"number","description":"Livestream revenue.","example":300},"showcase_revenue":{"type":"number","description":"Showcase revenue.","example":100},"revenue_growth_rate":{"type":"number","description":"Revenue growth percentage.","example":12.5},"commission_rate":{"type":"number","description":"Commission percentage.","example":20},"launch_date":{"type":"string","description":"Product launch date.","example":"2026-01-01"},"product_region":{"type":"string","description":"Product market region.","example":"US"},"product_shop_id":{"type":"string","description":"Owning shop ID.","example":"shop-id"},"min_price":{"type":"number","description":"Minimum product price.","example":9.99},"max_price":{"type":"number","description":"Maximum product price.","example":19.99},"product_review_count":{"type":"integer","description":"Review count.","example":200},"video_number":{"type":"integer","description":"Associated video count.","example":25},"live_number":{"type":"integer","description":"Associated livestream count.","example":5},"creator_number":{"type":"integer","description":"Associated creator count.","example":10}}}},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":[{"product_id":"1732505564636812173","product_name":"Example product","unit_price":12.99,"sales_volumn":100,"revenue":1000,"video_revenue":600,"live_revenue":300,"showcase_revenue":100,"revenue_growth_rate":12.5,"commission_rate":20,"launch_date":"2026-01-01","product_region":"US","product_shop_id":"shop-id","min_price":9.99,"max_price":19.99,"product_review_count":200,"video_number":25,"live_number":5,"creator_number":10}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-product-analytics-api","x-nexscope-mcp-tool-name":"nexscope_tiktok_product_analytics_api","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-product-discovery/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"Tiktok Product Discovery","description":"Search and filter TikTok global e-commerce products based on FastMoss data, supporting keyword search, multi-dimensional filtering (category, shop type, commission rate, sales, creator count, etc.) and sorting. Trigger when users mention TikTok product selection, TikTok product search, TikTok product data, TikTok creator sales, TikTok commission rate, TikTok bestseller tracking, TikTok GMV analysis, TikTok product search, TikTok product research, TikTok creator sales, TikTok commission rate, TikTok GMV analysis, FastMoss. Even if the user does not explicitly mention \"FastMoss\", trigger this skill whenever their need involves searching product data or analyzing product performance on TikTok.","operationId":"runTiktokProductDiscovery","externalDocs":{"description":"Tiktok Product Discovery documentation","url":"https://www.nexscope.ai/api-docs/tiktok-product-discovery"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.tiktok-product-discovery.","properties":{"keyword":{"type":"string","description":"Search keyword (fuzzy match on product title)","example":"phone case"},"region":{"type":"string","description":"Market region code. Options: US (United States), GB (United Kingdom), MX (Mexico), ES (Spain), DE (Germany), IT (Italy), FR (France), ID (Indonesia), VN (Vietnam), MY (Malaysia), TH (Thailand), PH (Philippines), BR (Brazil), JP (Japan), SG (Singapore)","example":"US"},"category":{"type":"string","description":"English category name, automatically matched to TikTok category ID. Non-English input must be translated to English first"},"shopType":{"type":"integer","description":"Store type: 1=local store, 2=cross-border store","example":1},"isTopSelling":{"type":"boolean","description":"Filter hot-selling products only","example":false},"isNewListed":{"type":"boolean","description":"Filter newly listed products only","example":false},"isSshop":{"type":"boolean","description":"Filter TikTok fully managed (S-shop) products only","example":false},"isFreeShipping":{"type":"boolean","description":"Filter free shipping products only","example":false},"isLocalWarehouse":{"type":"boolean","description":"Filter local warehouse shipping products only","example":false},"unitsSoldRange":{"type":"object","description":"Sales volume range filter, format: {\"min\": 100, \"max\": 5000}","example":{},"properties":{},"additionalProperties":true},"commissionRateRange":{"type":"object","description":"Commission rate range filter, format: {\"min\": 0.05, \"max\": 0.20} (decimal, 0.10=10%)","example":{},"properties":{},"additionalProperties":true},"creatorCountRange":{"type":"object","description":"Creator count range filter, format: {\"min\": 10, \"max\": 500}","example":{},"properties":{},"additionalProperties":true},"orderField":{"type":"string","description":"Sort field: day7_units_sold (7-day sales), day7_gmv (7-day GMV), commission_rate (commission rate), total_units_sold (total sales), total_gmv (total GMV), creator_count (creator count). Default descending order"},"page":{"type":"integer","description":"Page number, default 1","example":1},"pageSize":{"type":"integer","description":"Items per page, max 10, default 10","example":10},"pageNumber":{"type":"integer"}},"example":{"region":"US","pageSize":10,"keyword":"phone case","pageNumber":1},"additionalProperties":true},"example":{"region":"US","pageSize":10,"keyword":"phone case","pageNumber":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total number of matching records","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product information list (see below)","example":[],"items":{"type":"object","properties":{"title":{"type":"string","description":"Product title","example":null},"productId":{"type":"string","description":"Product unique identifier ID","example":"example-id"},"region":{"type":"string","description":"Market region code","example":"US"},"price":{"type":"number","description":"Product price","example":1},"minPrice":{"type":"number","description":"Minimum price","example":1},"maxPrice":{"type":"number","description":"Maximum price","example":1},"currency":{"type":"string","description":"Currency code","example":null},"totalSaleCnt":{"type":"integer","description":"Cumulative total sales","example":1},"totalSale1dCnt":{"type":"integer","description":"1-day sales","example":1},"totalSale7dCnt":{"type":"integer","description":"7-day sales","example":1},"totalSale28dCnt":{"type":"integer","description":"28-day sales","example":1},"totalSale90dCnt":{"type":"integer","description":"90-day sales","example":1},"totalSaleGmvAmt":{"type":"number","description":"Cumulative total GMV","example":1},"totalSaleGmv7dAmt":{"type":"number","description":"7-day GMV","example":1},"totalSaleGmv28dAmt":{"type":"number","description":"28-day GMV","example":1},"totalVideoCnt":{"type":"integer","description":"Number of promotional videos","example":1},"totalLiveCnt":{"type":"integer","description":"Number of livestream promotions","example":1},"totalIflCnt":{"type":"integer","description":"Number of promoting creators","example":1},"productCommissionRate":{"type":"number","description":"Product commission rate (decimal, 0.10=10%)","example":1},"productRating":{"type":"number","description":"Product rating","example":1},"reviewCount":{"type":"integer","description":"Review count","example":1},"skuCount":{"type":"integer","description":"SKU count","example":1},"shopName":{"type":"string","description":"Store name","example":null},"shopSellerId":{"type":"string","description":"Seller ID","example":"example-id"},"shopTotalUnitsSold":{"type":"integer","description":"Store total sales","example":1},"isCrossBorder":{"type":"integer","description":"Whether cross-border: 1=cross-border, 0=local","example":1},"isSShopText":{"type":"string","description":"Whether a fully managed store (Yes/No)","example":null},"freeShippingText":{"type":"string","description":"Whether free shipping (Yes/No)","example":null},"availableDate":{"type":"string","description":"Listing time","example":"2026-01-01"},"categoryName":{"type":"string","description":"Product category name","example":null},"salesTrendFlagText":{"type":"string","description":"Sales trend indicator","example":null},"tiktokUrl":{"type":"string","description":"TikTok product link","example":"https://example.com/image.jpg"},"fastmossUrl":{"type":"string","description":"FastMoss product detail link","example":"https://example.com/image.jpg"},"imageUrl":{"type":"string","description":"Product image URL","example":"https://example.com/image.jpg"}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render column definitions","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style type","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"productId":"example-id","region":"US","price":1,"minPrice":1,"maxPrice":1,"totalSaleCnt":1,"totalSale1dCnt":1,"totalSale7dCnt":1,"totalSale28dCnt":1,"totalSale90dCnt":1,"totalSaleGmvAmt":1,"totalSaleGmv7dAmt":1,"totalSaleGmv28dAmt":1,"totalVideoCnt":1,"totalLiveCnt":1,"totalIflCnt":1,"productCommissionRate":1,"productRating":1,"reviewCount":1,"skuCount":1,"shopSellerId":"example-id","shopTotalUnitsSold":1,"isCrossBorder":1,"availableDate":"2026-01-01","tiktokUrl":"https://example.com/image.jpg","fastmossUrl":"https://example.com/image.jpg","imageUrl":"https://example.com/image.jpg"}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-product-discovery","x-nexscope-mcp-tool-name":"nexscope_tiktok_product_discovery","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-product-search/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"Tiktok Product Search","description":"Search and analyze TikTok product data including sales, influencer sales data, pricing, and commission rates across 16 TikTok Shop sites. Trigger when users mention TikTok product search, TikTok Shop product analysis, TikTok sales data, influencer sales, TikTok product selection, TikTok commission rate, TikTok product ranking, Nexscope data query, TikTok product search, TikTok sales, influencer sales, TikTok commission, TikTok product selection, short-video e-commerce, TikTok data. Even if the user does not explicitly mention \"Nexscope\" or \"TikTok\", trigger this skill whenever their need involves searching products on TikTok Shop or analyzing TikTok product performance metrics.","operationId":"runTiktokProductSearch","externalDocs":{"description":"Tiktok Product Search documentation","url":"https://www.nexscope.ai/api-docs/tiktok-product-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.tiktok-product-search.","properties":{"keyword":{"type":"string","description":"Product keyword (please translate to the local language). Max length 1000","example":"phone case"},"region":{"type":"string","description":"Region, default US. Options: US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (United Kingdom), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France)","example":"US"},"categoryKeywordCN":{"type":"string","description":"Product category (please enter in Chinese). Max length 1000","example":"phone case"},"minTotalSaleCnt":{"type":"integer","description":"Total sales (minimum)","example":1},"maxTotalSaleCnt":{"type":"integer","description":"Total sales (maximum)","example":1},"minTotalSale30dCnt":{"type":"integer","description":"30-day sales (minimum)","example":1},"maxTotalSale30dCnt":{"type":"integer","description":"30-day sales (maximum)","example":1},"minTotalSaleGmvAmt":{"type":"string","description":"Product total GMV (minimum). Max length 1000"},"maxTotalSaleGmvAmt":{"type":"string","description":"Product total GMV (maximum). Max length 1000"},"minTotalSaleGmv30dAmt":{"type":"string","description":"Product total GMV (30-day) (minimum). Max length 1000"},"maxTotalSaleGmv30dAmt":{"type":"string","description":"Product total GMV (30-day) (maximum). Max length 1000"},"minSpuAvgPrice":{"type":"number","description":"SPU average price (minimum)","example":1},"maxSpuAvgPrice":{"type":"number","description":"SPU average price (maximum)","example":1},"minProductRating":{"type":"number","description":"Product rating (minimum)","example":1},"maxProductRating":{"type":"number","description":"Product rating (maximum)","example":1},"minReviewCount":{"type":"integer","description":"Review count (minimum)","example":1},"maxReviewCount":{"type":"integer","description":"Review count (maximum)","example":1},"minProductCommissionRate":{"type":"number","description":"Product commission rate (minimum). Input as percentage will be automatically converted to decimal, e.g., 5%->0.05","example":1},"maxProductCommissionRate":{"type":"number","description":"Product commission rate (maximum). Input as percentage will be automatically converted to decimal, e.g., 5%->0.05","example":1},"minTotalIflCnt":{"type":"integer","description":"Promoting creator count (minimum)","example":1},"maxTotalIflCnt":{"type":"integer","description":"Promoting creator count (maximum)","example":1},"minTotalVideoCnt":{"type":"integer","description":"Promotional video count (minimum)","example":1},"maxTotalVideoCnt":{"type":"integer","description":"Promotional video count (maximum)","example":1},"minTotalViewsCnt":{"type":"integer","description":"Promotional view count (minimum)","example":1},"maxTotalViewsCnt":{"type":"integer","description":"Promotional view count (maximum)","example":1},"minFirstCrawlDt":{"type":"integer","description":"Product listing time (minimum), format YYYYMMDD (e.g., 20200101 represents 2020-01-01)","example":1},"maxFirstCrawlDt":{"type":"integer","description":"Product listing time (maximum), format YYYYMMDD","example":1},"saleDays":{"type":"integer","description":"Days the product has been on sale, unit is days","example":1},"productSortField":{"type":"integer","description":"Sort field: 1=total sales, 2=total GMV, 3=SPU average price, 4=7-day sales, 5=30-day sales, 6=7-day GMV, 7=30-day GMV. Default 1","example":1},"sortType":{"type":"integer","description":"Sort direction: 0=ascending, 1=descending. Default 1","example":1},"pageNum":{"type":"integer","description":"Page number. Default 1","example":1},"pageSize":{"type":"integer","description":"Items per page. Default 50","example":10},"pageNumber":{"type":"integer"}},"example":{"region":"US","pageSize":10,"keyword":"phone case","pageNumber":1},"additionalProperties":true},"example":{"region":"US","pageSize":10,"keyword":"phone case","pageNumber":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Record count","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product information list (see below)","example":[],"items":{"type":"object","properties":{"productId":{"type":"string","description":"Product unique identifier ID","example":"example-id"},"productName":{"type":"string","description":"Product name","example":null},"title":{"type":"string","description":"Product name","example":null},"imageUrl":{"type":"string","description":"Product image URL","example":"https://example.com/image.jpg"},"coverUrl":{"type":"string","description":"Cover image URL list","example":"https://example.com/image.jpg"},"productImageUrls":{"type":"array","description":"Product image URL list","example":[]},"categoryName":{"type":"string","description":"Product category name","example":null},"categoryIds":{"type":"array","description":"Product category ID list","example":[]},"region":{"type":"string","description":"Region code","example":"US"},"currency":{"type":"string","description":"Currency","example":null},"price":{"type":"number","description":"Product price","example":1},"minPrice":{"type":"number","description":"Minimum price","example":1},"maxPrice":{"type":"number","description":"Maximum price","example":1},"spuAvgPrice":{"type":"number","description":"SPU average price","example":1},"productRating":{"type":"number","description":"Product rating","example":1},"reviewCount":{"type":"integer","description":"Review count","example":1},"ratings":{"type":"integer","description":"Review count","example":1},"productCommissionRate":{"type":"number","description":"Product commission rate","example":1},"totalSaleCnt":{"type":"integer","description":"Total sales","example":1},"totalSale1dCnt":{"type":"integer","description":"Total sales in 1 day","example":1},"totalSale7dCnt":{"type":"integer","description":"Total sales in 7 days","example":1},"totalSale15dCnt":{"type":"integer","description":"Total sales in 15 days","example":1},"totalSale30dCnt":{"type":"integer","description":"Total sales in 30 days","example":1},"totalSale60dCnt":{"type":"integer","description":"Total sales in 60 days","example":1},"totalSale90dCnt":{"type":"integer","description":"Total sales in 90 days","example":1},"monthlySalesUnits":{"type":"integer","description":"Monthly sales","example":1},"totalSaleGmvAmt":{"type":"number","description":"Total GMV","example":1},"totalSaleGmv1dAmt":{"type":"number","description":"Total GMV in 1 day","example":1},"totalSaleGmv7dAmt":{"type":"number","description":"Total GMV in 7 days","example":1},"totalSaleGmv15dAmt":{"type":"number","description":"Total GMV in 15 days","example":1},"totalSaleGmv30dAmt":{"type":"number","description":"Total GMV in 30 days","example":1},"totalSaleGmv60dAmt":{"type":"number","description":"Total GMV in 60 days","example":1},"totalSaleGmv90dAmt":{"type":"number","description":"Total GMV in 90 days","example":1},"firstCrawlDt":{"type":"integer","description":"Listing date","example":1},"availableDate":{"type":"string","description":"Listing time (timestamp)","example":"2026-01-01"},"discount":{"type":"string","description":"Discount info","example":null},"freeShippingText":{"type":"string","description":"Whether free shipping","example":null},"offMarkText":{"type":"string","description":"Whether there is a discount mark","example":null},"salesFlagText":{"type":"string","description":"Selling method","example":null},"salesTrendFlagText":{"type":"string","description":"Sales trend indicator","example":null},"isSShopText":{"type":"string","description":"Whether S store","example":null},"salePropsInfo":{"type":"array","description":"Sales property info (product specifications)","example":[]},"sourceTool":{"type":"string","description":"Source tool","example":null},"sourceType":{"type":"string","description":"Product source","example":null},"asin":{"type":"string","description":"Product ID","example":"B072MQ5BRX"}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"productId":"example-id","imageUrl":"https://example.com/image.jpg","coverUrl":"https://example.com/image.jpg","productImageUrls":[],"categoryIds":[],"region":"US","price":1,"minPrice":1,"maxPrice":1,"spuAvgPrice":1,"productRating":1,"reviewCount":1,"ratings":1,"productCommissionRate":1,"totalSaleCnt":1,"totalSale1dCnt":1,"totalSale7dCnt":1,"totalSale15dCnt":1,"totalSale30dCnt":1,"totalSale60dCnt":1,"totalSale90dCnt":1,"monthlySalesUnits":1,"totalSaleGmvAmt":1,"totalSaleGmv1dAmt":1,"totalSaleGmv7dAmt":1,"totalSaleGmv15dAmt":1,"totalSaleGmv30dAmt":1,"totalSaleGmv60dAmt":1,"totalSaleGmv90dAmt":1,"firstCrawlDt":1,"availableDate":"2026-01-01","salePropsInfo":[],"asin":"B072MQ5BRX"}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-product-search","x-nexscope-mcp-tool-name":"nexscope_tiktok_product_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-seller-detail/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"Tiktok Seller Detail","description":"Query TikTok Shop store (seller) details, retrieving a complete store profile by sellerId with total sales, multi-period (1d/7d/30d/90d) sales and GMV, followers, rating, review count, positive feedback rate, delivery rate, response rate, in-store product count, promoting creator count, promotional video count, livestream count, price range, product categories, and estimated listing time. Trigger when users mention TikTok store detail, TikTok seller detail, TikTok store analysis, TikTok store data, TikTok store profile, TikTok Shop store detail, TikTok seller detail, Nexscope store profile. Even if the user does not explicitly mention \"Nexscope\" or \"TikTok\", trigger this skill whenever their need involves querying the full detail/profile of a specific TikTok Shop store (with a known sellerId).","operationId":"runTiktokSellerDetail","externalDocs":{"description":"Tiktok Seller Detail documentation","url":"https://www.nexscope.ai/api-docs/tiktok-seller-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.tiktok-seller-detail.","properties":{"sellerId":{"type":"string","description":"TikTok Shop seller ID. Obtainable from the \"Nexscope TikTok Seller Search\" skill (nexscope-echotik-list-seller) results, or from the ID in a known store link. Max length 1000","example":"7496162162184128712"}},"required":["sellerId"],"example":{"sellerId":"7496162162184128712"},"additionalProperties":true},"example":{"sellerId":"7496162162184128712"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"costToken":{"anyOf":[{"type":"integer","description":"Token cost","example":1},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render column definitions (display metadata)","example":[],"items":{"type":"object","properties":{"sellerName":{"type":"string","description":"Store name","example":null},"sellerLink":{"type":"string","description":"Store link","example":null},"salesFlagText":{"type":"string","description":"Primary selling method (video sales / livestream sales)","example":null},"salesTrendFlagText":{"type":"string","description":"Sales trend (rising / falling / stable)","example":null},"shopIdentityLabel":{"type":"string","description":"Store identity (e.g., OFFICIAL SHOP)","example":null},"shopTypeText":{"type":"string","description":"Whether a brand store (Yes / No)","example":null},"fromFlagText":{"type":"string","description":"Cross-border identifier (local / cross-border)","example":null},"productCategoryList":{"type":"string","description":"Product categories (JSON string, containing category_name / category_id)","example":null},"mostProductCategoryList":{"type":"string","description":"TOP1 product category (JSON string)","example":null}}}},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style (e.g., tableListWorkbenches)","example":null},{"type":"null"}]},"sellerId":{"anyOf":[{"type":"string","description":"Store ID","example":"example-id"},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","description":"Store cover image URL","example":"https://example.com/image.jpg"},{"type":"null"}]},"region":{"anyOf":[{"type":"string","description":"Region","example":"US"},{"type":"null"}]},"categoryId":{"anyOf":[{"type":"string","description":"Primary category ID","example":"example-id"},{"type":"null"}]},"categoryL2Id":{"anyOf":[{"type":"string","description":"Secondary category ID","example":"example-id"},{"type":"null"}]},"categoryL3Id":{"anyOf":[{"type":"string","description":"Tertiary category ID","example":"example-id"},{"type":"null"}]},"totalSaleCnt":{"anyOf":[{"type":"integer","description":"Total sales","example":1},{"type":"null"}]},"totalSale1dCnt":{"anyOf":[{"type":"integer","description":"Sales in last 1 day (increment)","example":1},{"type":"null"}]},"totalSale7dCnt":{"anyOf":[{"type":"integer","description":"Sales in last 7 days (increment)","example":1},{"type":"null"}]},"totalSale30dCnt":{"anyOf":[{"type":"integer","description":"Sales in last 30 days (increment)","example":1},{"type":"null"}]},"totalSale90dCnt":{"anyOf":[{"type":"integer","description":"Sales in last 90 days (increment)","example":1},{"type":"null"}]},"totalSaleGmvAmt":{"anyOf":[{"type":"number","description":"Total GMV","example":1},{"type":"null"}]},"totalSaleGmv1dAmt":{"anyOf":[{"type":"number","description":"GMV in last 1 day (increment)","example":1},{"type":"null"}]},"totalSaleGmv7dAmt":{"anyOf":[{"type":"number","description":"GMV in last 7 days (increment)","example":1},{"type":"null"}]},"totalSaleGmv30dAmt":{"anyOf":[{"type":"number","description":"GMV in last 30 days (increment)","example":1},{"type":"null"}]},"totalSaleGmv90dAmt":{"anyOf":[{"type":"number","description":"GMV in last 90 days (increment)","example":1},{"type":"null"}]},"followersCount":{"anyOf":[{"type":"integer","description":"Follower count","example":1},{"type":"null"}]},"rating":{"anyOf":[{"type":"number","description":"Rating","example":1},{"type":"null"}]},"reviewCount":{"anyOf":[{"type":"integer","description":"Review count","example":1},{"type":"null"}]},"positiveFeedbackRate":{"anyOf":[{"type":"number","description":"Positive feedback rate","example":1},{"type":"null"}]},"responseRate":{"anyOf":[{"type":"number","description":"Response rate","example":1},{"type":"null"}]},"deliveryRate":{"anyOf":[{"type":"integer","description":"Delivery rate","example":1},{"type":"null"}]},"totalProductCnt":{"anyOf":[{"type":"integer","description":"Historical product count in store (including delisted)","example":1},{"type":"null"}]},"totalCrawlProductCnt":{"anyOf":[{"type":"integer","description":"Current product count in store","example":1},{"type":"null"}]},"spuAvgPrice":{"anyOf":[{"type":"number","description":"Average SKU price across the store","example":1},{"type":"null"}]},"minPrice":{"anyOf":[{"type":"integer","description":"Minimum price","example":1},{"type":"null"}]},"maxPrice":{"anyOf":[{"type":"integer","description":"Maximum price","example":1},{"type":"null"}]},"totalIflCnt":{"anyOf":[{"type":"integer","description":"Total promoting creator count","example":1},{"type":"null"}]},"totalVideoCnt":{"anyOf":[{"type":"integer","description":"Total promotional video count","example":1},{"type":"null"}]},"totalLiveCnt":{"anyOf":[{"type":"integer","description":"Total livestream count","example":1},{"type":"null"}]},"firstCrawlDt":{"anyOf":[{"type":"integer","description":"Estimated listing time, in yyyyMMdd format (e.g., 20240504 represents 2024-05-04)","example":1},{"type":"null"}]},"userId":{"anyOf":[{"type":"string","description":"Creator UID","example":"example-id"},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Product source (e.g., Tiktok)","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Source tool (e.g., EchoTik-Seller Detail)","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"costToken":1,"columns":[],"sellerId":"example-id","coverUrl":"https://example.com/image.jpg","region":"US","categoryId":"example-id","categoryL2Id":"example-id","categoryL3Id":"example-id","totalSaleCnt":1,"totalSale1dCnt":1,"totalSale7dCnt":1,"totalSale30dCnt":1,"totalSale90dCnt":1,"totalSaleGmvAmt":1,"totalSaleGmv1dAmt":1,"totalSaleGmv7dAmt":1,"totalSaleGmv30dAmt":1,"totalSaleGmv90dAmt":1,"followersCount":1,"rating":1,"reviewCount":1,"positiveFeedbackRate":1,"responseRate":1,"deliveryRate":1,"totalProductCnt":1,"totalCrawlProductCnt":1,"spuAvgPrice":1,"minPrice":1,"maxPrice":1,"totalIflCnt":1,"totalVideoCnt":1,"totalLiveCnt":1,"firstCrawlDt":1,"userId":"example-id"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-seller-detail","x-nexscope-mcp-tool-name":"nexscope_tiktok_seller_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-shop-analytics/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"Tiktok Shop Analytics","description":"Search TikTok e-commerce store leaderboards via Kalodata and query detailed information for specific stores. Supports viewing high-ranking, high-sales TikTok Shop stores by region, currency, language, and date range, and using shopId to retrieve revenue, sales volume, on-sale product count, self-operated/affiliate/shopping mall channel revenue, and creator collaboration count. Trigger when users mention TikTok store ranking, TikTok shop leaderboard, TikTok top shops, TikTok store ranking, TikTok Shop store ranking, kalodata store search, kalodata store ranking, TikTok store detail, TikTok shop profile, store revenue, store sales, TikTok shop ranking, TikTok shop leaderboard, TikTok top shops, TikTok store ranking, TikTok shop detail, TikTok store detail, kalodata shop search/detail. Even if the user does not explicitly mention \"kalodata\", trigger this skill whenever their need involves viewing TikTok store leaderboards or detailed data for a specific TikTok store.","operationId":"runTiktokShopAnalytics","externalDocs":{"description":"Tiktok Shop Analytics documentation","url":"https://www.nexscope.ai/api-docs/tiktok-shop-analytics"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.tiktok-shop-analytics.","properties":{"region":{"type":"string","description":"Region/market code, e.g., US. Max length 1000","example":"US"},"dateRange":{"type":"string","description":"Time range, e.g., last7Day (last 7 days), last30Day (last 30 days). Max length 1000","example":"last30Day"},"pageNumber":{"type":"integer","description":"Page number, value range 1-5 (out of range returns errcode 501)","example":1},"pageSize":{"type":"integer","description":"Items per page, value range 5-100","example":10},"language":{"type":"string","description":"Return language, e.g., zh-CN, en-US. Max length 1000"},"currency":{"type":"string","description":"Currency unit, e.g., USD. Max length 1000"},"sortField":{"type":"object","description":"Sort criteria; pass an empty object {} for default rank order when not sorting","example":{},"properties":{},"additionalProperties":true},"shopId":{"type":"string","description":"TikTok shop unique ID (string, to avoid large integer precision loss), e.g., 7495514739648989419. Obtainable from the shop_id field in the shop rank response","example":"7496162162184128712"},"category_ids":{"type":"array","description":"Category ID list filter; results use the selected category dimension","example":[]},"revenue_range":{"type":"string","description":"Revenue / GMV range filter"},"shop_type":{"type":"string","description":"Shop type filter: BRAND or RETAILER"},"category_id":{"type":"string","description":"Optional category ID dimension"}},"example":{"sortField":{},"dateRange":"last30Day","pageSize":10,"shopId":"7496162162184128712","pageNumber":1,"region":"US"},"additionalProperties":true},"example":{"sortField":{},"dateRange":"last30Day","pageSize":10,"shopId":"7496162162184128712","pageNumber":1,"region":"US"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"array","description":"Shop rank list (rank) or 1-element detail array (detail)","example":[],"items":{"type":"object","properties":{"rank":{"type":"integer","description":"Rank position (1 is highest)","example":1},"shop_name":{"type":"string","description":"Shop name","example":null},"shop_id":{"type":"string","description":"Shop unique ID (string, to avoid large integer precision loss)","example":"example-id"},"shop_type":{"type":"string","description":"Shop type (e.g., BRAND)","example":null},"revenue":{"type":"number","description":"Total revenue / GMV (in the requested currency)","example":1},"sales_volumn":{"type":"integer","description":"Sales volume (note the field is spelled volumn)","example":1},"on_sell_product_count":{"type":"integer","description":"Products currently on sale","example":1},"unit_price":{"type":"number","description":"Unit price (in the requested currency)","example":1},"revenue_growth_rate":{"type":"number","description":"Revenue growth rate (%, can be positive or negative)","example":1},"self_promotion_revenue":{"type":"number","description":"Self-operated/self-promoted revenue","example":1},"affiliate_revenue":{"type":"number","description":"Affiliate distribution revenue","example":1},"shopping_mall_revenue":{"type":"number","description":"Mall revenue","example":1},"seller_type":{"type":"string","description":"Shop/seller type (e.g., BRAND) -- detail uses seller_type, not shop_type","example":null},"region":{"type":"string","description":"Region/market (e.g., US)","example":"US"},"product_number":{"type":"integer","description":"Products currently on sale","example":1},"self_account_revenue":{"type":"number","description":"Self-operated/self-broadcast revenue -- detail uses self_account_revenue, not self_promotion_revenue","example":1},"shoppingmall_revenue":{"type":"number","description":"Mall revenue (note: no underscore between shopping and mall)","example":1},"creator_number":{"type":"integer","description":"Creator collaborations","example":1},"video_number":{"type":"integer","description":"Associated video count","example":1},"live_number":{"type":"integer","description":"Associated livestream count","example":1}}}},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed for this call, fixed at 14000","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":[{"rank":1,"shop_id":"example-id","revenue":1,"sales_volumn":1,"on_sell_product_count":1,"unit_price":1,"revenue_growth_rate":1,"self_promotion_revenue":1,"affiliate_revenue":1,"shopping_mall_revenue":1,"region":"US","product_number":1,"self_account_revenue":1,"shoppingmall_revenue":1,"creator_number":1,"video_number":1,"live_number":1}],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-shop-analytics","x-nexscope-mcp-tool-name":"nexscope_tiktok_shop_analytics","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-top-selling-products/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"Tiktok Top Selling Products","description":"Query TikTok global e-commerce market top-selling product rankings via FastMoss data, supporting daily/weekly/monthly dimensions and category-level analysis. Trigger when users mention TikTok bestseller chart, TikTok hot product ranking, TikTok sales ranking, TikTok GMV ranking, TikTok category bestsellers, TikTok weekly product report, TikTok top-selling rankings, TikTok bestseller charts, TikTok GMV ranking, TikTok category hot sellers, TikTok weekly product report, FastMoss. Even if the user does not explicitly mention \"FastMoss\", trigger this skill whenever their need involves viewing TikTok platform bestseller rankings or sales rankings by time dimension.","operationId":"runTiktokTopSellingProducts","externalDocs":{"description":"Tiktok Top Selling Products documentation","url":"https://www.nexscope.ai/api-docs/tiktok-top-selling-products"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.tiktok-top-selling-products.","properties":{"region":{"type":"string","description":"Market region code. Options: US (United States), GB (United Kingdom), MX (Mexico), ES (Spain), DE (Germany), IT (Italy), FR (France), ID (Indonesia), VN (Vietnam), MY (Malaysia), TH (Thailand), PH (Philippines), BR (Brazil), JP (Japan), SG (Singapore)","example":"US"},"dateInfo":{"type":"object","description":"Date specification object, containing type and value fields","example":{"type":"day","value":"2026-08-01"},"properties":{"type":{"type":"string","description":"Time granularity: day, week, month","example":"day"},"value":{"type":"string","description":"Date value: day format YYYY-MM-DD, week format YYYY-weekNumber (e.g., 2025-18), month format YYYY-MM","example":"2026-01-01"}},"additionalProperties":true,"required":["type","value"]},"category":{"type":"string","description":"Product category name (English), matched to TikTok category ID. Non-English input must be translated to English first"},"orderby":{"type":"object","description":"Sort rule object, containing field and order fields","example":{"order":"desc","field":"units_sold"},"properties":{"order":{"type":"string","description":"Sort direction: desc (descending), asc (ascending), default desc","example":"desc"},"field":{"type":"string","description":"Sort field: units_sold (sales), gmv (GMV), total_units_sold (total sales), total_gmv (total GMV), growth_rate (growth rate)","example":"units_sold"}},"additionalProperties":true},"page":{"type":"integer","description":"Page number, default 1","example":1},"pageSize":{"type":"integer","description":"Items per page, max 10, default 10","example":10}},"required":["region","dateInfo"],"example":{"region":"US","pageSize":10,"orderby":{"order":"desc","field":"units_sold"},"dateInfo":{"type":"day","value":"2026-08-01"},"page":1},"additionalProperties":true},"example":{"region":"US","pageSize":10,"orderby":{"order":"desc","field":"units_sold"},"dateInfo":{"type":"day","value":"2026-08-01"},"page":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Record count","example":1},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page number","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Current page size","example":null},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Hot selling product list (see product object below)","example":[],"items":{"type":"object","properties":{"matchedCategoryIdPath":{"type":"string","description":"Matched category ID path when category is supplied","example":null},"matchedCategoryNamePath":{"type":"string","description":"Matched category name path when category is supplied","example":null},"title":{"type":"string","description":"Product name","example":null},"productId":{"type":"string","description":"Product ID","example":"example-id"},"region":{"type":"string","description":"Region code","example":"US"},"price":{"type":"number","description":"Product price","example":1},"minPrice":{"type":"number","description":"Minimum price","example":1},"maxPrice":{"type":"number","description":"Maximum price","example":1},"currency":{"type":"string","description":"Currency","example":null},"totalSaleCnt":{"type":"integer","description":"Total sales","example":1},"totalSale1dCnt":{"type":"integer","description":"Sales in last 1 day (returned when dateType=day)","example":1},"totalSale7dCnt":{"type":"integer","description":"Sales in last 7 days (returned when dateType=week)","example":1},"totalSale30dCnt":{"type":"integer","description":"Sales in last 30 days (returned when dateType=month)","example":1},"totalSaleGmvAmt":{"type":"number","description":"Total GMV","example":1},"totalSaleGmv1dAmt":{"type":"number","description":"GMV in last 1 day (returned when dateType=day)","example":1},"totalSaleGmv7dAmt":{"type":"number","description":"GMV in last 7 days (returned when dateType=week)","example":1},"totalSaleGmv30dAmt":{"type":"number","description":"GMV in last 30 days (returned when dateType=month)","example":1},"growthRate":{"type":"number","description":"Growth rate (percentage)","example":1},"shopName":{"type":"string","description":"Store name","example":null},"shopTotalUnitsSold":{"type":"integer","description":"Store total sales","example":1},"shopSellerId":{"type":"string","description":"Store seller ID","example":"example-id"},"categoryName":{"type":"string","description":"Product category","example":null},"categoryIds":{"type":"array","description":"Category ID path from first to third level","example":null},"productCommissionRate":{"type":"number","description":"Product commission rate (basis points, 1000=10%)","example":1},"imageUrl":{"type":"string","description":"Product image URL","example":"https://example.com/image.jpg"},"coverUrl":{"type":"array","description":"Product cover image URLs","example":null},"shopAvatar":{"type":"string","description":"Shop avatar URL","example":null},"sourceTool":{"type":"string","description":"Source tool identifier","example":null},"sourceType":{"type":"string","description":"Product source type","example":null},"offShelvesText":{"type":"string","description":"Whether delisted (\"Yes\"=delisted, \"No\"=on sale)","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Upstream execution time in milliseconds","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"productId":"example-id","region":"US","price":1,"minPrice":1,"maxPrice":1,"totalSaleCnt":1,"totalSale1dCnt":1,"totalSale7dCnt":1,"totalSale30dCnt":1,"totalSaleGmvAmt":1,"totalSaleGmv1dAmt":1,"totalSaleGmv7dAmt":1,"totalSaleGmv30dAmt":1,"growthRate":1,"shopTotalUnitsSold":1,"shopSellerId":"example-id","productCommissionRate":1,"imageUrl":"https://example.com/image.jpg"}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-top-selling-products","x-nexscope-mcp-tool-name":"nexscope_tiktok_top_selling_products","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-video-analytics/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"Tiktok Video Analytics","description":"Search TikTok e-commerce trending promotional video leaderboards via Kalodata and query detailed data for specific videos. Supports viewing high-ranking/high-view/hot-selling promotional videos by region, currency, language, and date range, and using videoId to retrieve views, likes, comments, shares, revenue, GPM, and advertising metrics. Trigger when users mention TikTok video search, TikTok video ranking, TikTok viral video chart, TikTok video detail, video analytics, kalodata video search/detail. Even if the user does not explicitly mention \"kalodata\", trigger this skill whenever their need involves viewing TikTok trending promotional video leaderboards or detailed sales and engagement data for a specific TikTok video.","operationId":"runTiktokVideoAnalytics","externalDocs":{"description":"Tiktok Video Analytics documentation","url":"https://www.nexscope.ai/api-docs/tiktok-video-analytics"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.tiktok-video-analytics.","properties":{"region":{"type":"string","description":"Region/market code, e.g., US","example":"US"},"dateRange":{"type":"string","description":"Time range, e.g., last7Day, last30Day","example":"last30Day"},"pageNumber":{"type":"integer","description":"Page number, value range 1-5","example":1},"pageSize":{"type":"integer","description":"Items per page, value range 5-100","example":10},"language":{"type":"string","description":"Return language, e.g., zh-CN, en-US"},"currency":{"type":"string","description":"Currency unit, e.g., USD"},"sortField":{"type":"object","description":"Sort criteria; omitted to use default rank order","example":{},"properties":{},"additionalProperties":true},"videoId":{"type":"string","description":"TikTok video ID, e.g., 7659161409279806734, obtainable from the video_id in the video rank response","example":"6768504823336815877"},"category_id":{"type":"string","description":"Category ID filter"},"shop_id":{"type":"string","description":"Shop ID filter"},"creator_id":{"type":"string","description":"Creator ID filter"},"product_id":{"type":"string","description":"Product ID filter"},"revenue_range":{"type":"string","description":"GMV range; response field revenue is total GMV"},"followers_range":{"type":"string","description":"Creator follower range filter"},"ads_roas":{"type":"number","description":"Advertising ROAS filter"}},"example":{"sortField":{},"dateRange":"last30Day","pageSize":10,"pageNumber":1,"region":"US","videoId":"6768504823336815877"},"additionalProperties":true},"example":{"sortField":{},"dateRange":"last30Day","pageSize":10,"pageNumber":1,"region":"US","videoId":"6768504823336815877"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"array","description":"Rank or detail data","example":[],"items":{"type":"object","properties":{"video_id":{"type":"string","description":"Video ID, string format to avoid large integer precision loss","example":"example-id"},"video_title":{"type":"string","description":"Video title / caption","example":null},"views":{"type":"integer","description":"View count","example":1},"digg_count":{"type":"integer","description":"Like count","example":1},"comment_count":{"type":"integer","description":"Comment count","example":1},"share_count":{"type":"integer","description":"Share count","example":1},"revenue":{"type":"number","description":"Total revenue / GMV, returned in the requested currency","example":1},"revenue_growth_rate":{"type":"number","description":"Revenue growth rate (%), can be positive or negative","example":1},"ad":{"type":"integer","description":"Whether ad/promotional video flag (1=yes)","example":1},"ad_view_ratio":{"type":"number","description":"Ad view share (%)","example":1},"ad_revenue_ratio":{"type":"number","description":"Ad revenue share (%)","example":1},"ads_roas":{"type":"number","description":"Ad ROAS","example":1},"belonged_creator_id":{"type":"string","description":"Belonged creator ID","example":"example-id"},"belonged_creator_handle":{"type":"string","description":"Belonged creator username","example":null},"creator_debut":{"type":"string","description":"Creator debut date (YYYY-MM-DD)","example":null},"video_region":{"type":"string","description":"Video region, may be empty string","example":null},"sales_volumn":{"type":"integer","description":"Sales volume, field spelled as volumn","example":1},"video_gpm":{"type":"number","description":"Video GPM (GMV per thousand views)","example":1},"ads_views":{"type":"integer","description":"Ad view count","example":1},"ad_cpa":{"type":"number","description":"Ad CPA","example":1},"ads_period":{"type":"integer","description":"Ad running period (days)","example":1},"duration":{"type":"number","description":"Video duration (seconds)","example":1},"product_number":{"type":"integer","description":"Associated product count in the video","example":1}}}},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed for this call, typically 14000","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":[{"video_id":"example-id","views":1,"digg_count":1,"comment_count":1,"share_count":1,"revenue":1,"revenue_growth_rate":1,"ad":1,"ad_view_ratio":1,"ad_revenue_ratio":1,"ads_roas":1,"belonged_creator_id":"example-id","sales_volumn":1,"video_gpm":1,"ads_views":1,"ad_cpa":1,"ads_period":1,"duration":1,"product_number":1}],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-video-analytics","x-nexscope-mcp-tool-name":"nexscope_tiktok_video_analytics","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-video-download-url/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"Tiktok Video Download Url","description":"Resolve TikTok video URLs to return no-watermark/watermarked download addresses, playback addresses, and cover image addresses for saving promotional video assets or offline analysis. Trigger when users mention TikTok video download, TikTok watermark-free download, TikTok video save, download TikTok promotional video, TikTok no watermark video, TikTok video download, download TikTok video, no watermark TikTok video, save TikTok video, TikTok video link resolution. Even if the user does not explicitly mention \"Nexscope\", trigger this skill whenever their need involves extracting downloadable/playable video addresses from a TikTok video link.","operationId":"runTiktokVideoDownloadUrl","externalDocs":{"description":"Tiktok Video Download Url documentation","url":"https://www.nexscope.ai/api-docs/tiktok-video-download-url"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.tiktok-video-download-url.","properties":{"url":{"type":"string","description":"TikTok video URL, supports two formats: https://vt.tiktok.com/xxx short link or https://www.tiktok.com/@user/video/xxx full link. Max length 1000","example":"https://www.tiktok.com/@zachking/video/6768504823336815877"}},"required":["url"],"example":{"url":"https://www.tiktok.com/@zachking/video/6768504823336815877"},"additionalProperties":true},"example":{"url":"https://www.tiktok.com/@zachking/video/6768504823336815877"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"noWatermarkDownloadUrl":{"anyOf":[{"type":"string","description":"Video download URL (no watermark). Not all videos return this: some videos omit this field, in which case no-watermark download is unavailable","example":"https://example.com/image.jpg"},{"type":"null"}]},"downloadUrl":{"anyOf":[{"type":"string","description":"Video download URL (with watermark). Not all videos return this: omitted or present together with the no-watermark URL","example":"https://example.com/image.jpg"},{"type":"null"}]},"playUrl":{"anyOf":[{"type":"string","description":"Video play URL. When download URLs are absent, this serves as a fallback for playback/preview","example":"https://example.com/image.jpg"},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","description":"Video cover image URL (static)","example":"https://example.com/image.jpg"},{"type":"null"}]},"dynamicCoverUrl":{"anyOf":[{"type":"string","description":"Video dynamic cover URL","example":"https://example.com/image.jpg"},{"type":"null"}]},"videoId":{"anyOf":[{"type":"string","description":"Video ID","example":"example-id"},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render column definitions (field metadata: field/title/cellType/filterable/sortable, for frontend table rendering)","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style (e.g., tableListWorkbenches)","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"noWatermarkDownloadUrl":"https://example.com/image.jpg","downloadUrl":"https://example.com/image.jpg","playUrl":"https://example.com/image.jpg","coverUrl":"https://example.com/image.jpg","dynamicCoverUrl":"https://example.com/image.jpg","videoId":"example-id","columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-video-download-url","x-nexscope-mcp-tool-name":"nexscope_tiktok_video_download_url","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-video-search/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"Tiktok Video Search","description":"Search and analyze TikTok video data, filter videos by region, creator, product, category, views, duration, publish time, selling/ad/AI video flags, and return views, likes, comments, shares, favorites, video sales and GMV metrics across 16 TikTok Shop sites. Trigger when users mention TikTok video search, TikTok video list, TikTok promotional videos, TikTok video data, TikTok video views, TikTok video sales, TikTok video analytics, Nexscope video, TikTok video search, TikTok video list, TikTok video analytics, TikTok promotional videos, TikTok video views, TikTok video engagement. Even if the user does not explicitly mention \"Nexscope\" or \"TikTok\", trigger this skill whenever their need involves searching or analyzing TikTok video performance metrics by criteria.","operationId":"runTiktokVideoSearch","externalDocs":{"description":"Tiktok Video Search documentation","url":"https://www.nexscope.ai/api-docs/tiktok-video-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.tiktok-video-search.","properties":{"region":{"type":"string","description":"Region code. Options: US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (United Kingdom), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France)","example":"US"},"userId":{"type":"string","description":"Creator ID filter. Max length 1000","example":"example-id"},"productId":{"type":"string","description":"Associated product ID. Max length 1000"},"productCategoryId":{"type":"string","description":"Associated product category ID. Max length 1000","example":"example-id"},"minTotalViewsCnt":{"type":"integer","description":"Video view count filter (minimum)","example":1},"maxTotalViewsCnt":{"type":"integer","description":"Video view count filter (maximum)","example":1},"minDuration":{"type":"integer","description":"Video duration range filter (seconds) - minimum","example":1},"maxDuration":{"type":"integer","description":"Video duration range filter (seconds) - maximum","example":1},"minCreateTime":{"type":"integer","description":"Publish time range filter (seconds-level timestamp) - minimum","example":1},"maxCreateTime":{"type":"integer","description":"Publish time range filter (seconds-level timestamp) - maximum","example":1},"salesFlag":{"type":"integer","description":"Whether a promotional video: 0=non-promotional video, 1=promotional video","example":1},"isAd":{"type":"integer","description":"Whether an ad video: 0=non-ad video, 1=ad video","example":1},"createdByAi":{"type":"string","description":"Whether AI video, string \"true\"=AI video, \"false\"=non-AI video (regex ^(true"},"videoSortField":{"type":"integer","description":"Sort field: 1=total_digg_cnt (likes), 2=create_time (publish time), 3=total_views_cnt (views)","example":1},"sortType":{"type":"integer","description":"Sort direction: 0=ascending, 1=descending","example":1},"pageNum":{"type":"integer","description":"Page number, starting from 1","example":1},"pageSize":{"type":"integer","description":"Items per page. Must be a multiple of 10, max 100; the third-party API limit is 10 per page, internally the gateway fetches 10 per page in multiple rounds and merges","example":10},"keyword":{"type":"string"},"pageNumber":{"type":"integer"}},"required":["region"],"example":{"region":"US","pageSize":10,"keyword":"phone case","pageNumber":1},"additionalProperties":true},"example":{"region":"US","pageSize":10,"keyword":"phone case","pageNumber":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Record count","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Video list (see video fields below)","example":[],"items":{"type":"object","properties":{"videoId":{"type":"string","description":"Video ID","example":"example-id"},"videoDesc":{"type":"string","description":"Video description","example":null},"officialUrl":{"type":"string","description":"TikTok official video URL","example":"https://example.com/image.jpg"},"coverUrl":{"type":"string","description":"Video cover URL","example":"https://example.com/image.jpg"},"duration":{"type":"integer","description":"Video duration (seconds)","example":1},"width":{"type":"string","description":"Video width","example":null},"height":{"type":"string","description":"Video height","example":null},"ratio":{"type":"string","description":"Video resolution (e.g., 540p/720p)","example":null},"dataSize":{"type":"string","description":"Video file size","example":null},"createDate":{"type":"string","description":"Video publish date","example":"2026-01-01"},"userId":{"type":"string","description":"Creator ID","example":"example-id"},"uniqueId":{"type":"string","description":"TikTok account ID (unique_id)","example":"example-id"},"avatar":{"type":"string","description":"Creator avatar","example":null},"totalViewsCnt":{"type":"integer","description":"Total view count","example":1},"totalViews1dCnt":{"type":"integer","description":"Views in last 1 day","example":1},"totalViews7dCnt":{"type":"integer","description":"Views in last 7 days","example":1},"totalViews30dCnt":{"type":"integer","description":"Views in last 30 days","example":1},"totalDiggCnt":{"type":"integer","description":"Total like count","example":1},"totalDigg1dCnt":{"type":"integer","description":"Likes in last 1 day","example":1},"totalDigg7dCnt":{"type":"integer","description":"Likes in last 7 days","example":1},"totalDigg30dCnt":{"type":"integer","description":"Likes in last 30 days","example":1},"totalCommentsCnt":{"type":"integer","description":"Total comment count","example":1},"totalSharesCnt":{"type":"integer","description":"Total share count","example":1},"totalFavoritesCnt":{"type":"integer","description":"Total favorite count","example":1},"totalVideoSaleCnt":{"type":"integer","description":"Video sales (units)","example":1},"totalVideoSaleGmvAmt":{"type":"integer","description":"Video sales GMV (amount)","example":1},"salesFlagText":{"type":"string","description":"Whether promotional video","example":null},"isAdText":{"type":"string","description":"Whether ad video","example":null},"createdByAiText":{"type":"string","description":"Whether AI video (Yes/No/Unknown)","example":null},"productCategoryList":{"type":"string","description":"Product categories","example":null},"videoProducts":{"type":"string","description":"Video associated products","example":null},"region":{"type":"string","description":"Region code","example":"US"},"sourceType":{"type":"string","description":"Product source","example":null},"sourceTool":{"type":"string","description":"Source tool","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"data":[{"videoId":"example-id","officialUrl":"https://example.com/image.jpg","coverUrl":"https://example.com/image.jpg","duration":1,"createDate":"2026-01-01","userId":"example-id","uniqueId":"example-id","totalViewsCnt":1,"totalViews1dCnt":1,"totalViews7dCnt":1,"totalViews30dCnt":1,"totalDiggCnt":1,"totalDigg1dCnt":1,"totalDigg7dCnt":1,"totalDigg30dCnt":1,"totalCommentsCnt":1,"totalSharesCnt":1,"totalFavoritesCnt":1,"totalVideoSaleCnt":1,"totalVideoSaleGmvAmt":1,"region":"US"}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-video-search","x-nexscope-mcp-tool-name":"nexscope_tiktok_video_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/utility-patent-detector/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Utility Patent Detector","description":"Detect and search for similar utility/invention patents based on product information. Trigger when users mention utility patent detection, patent infringement risk, patent similarity search, patent screening, invention patent search, patent risk assessment, TRO (Temporary Restraining Order) risk analysis, utility patent, invention patent detection, patent infringement risk, patent search, TRO risk, Ruiguan. Even if the user does not explicitly say \"utility patent\", trigger this skill whenever their need involves checking whether a product may infringe existing utility/invention patents before selling in a target market.","operationId":"runUtilityPatentDetector","externalDocs":{"description":"Utility Patent Detector documentation","url":"https://www.nexscope.ai/api-docs/utility-patent-detector"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.utility-patent-detector.","properties":{"productTitle":{"type":"string","description":"Product title, max 1000 characters","example":"Magnetic phone case with ring stand"},"productDescription":{"type":"string","description":"Product description, max 1000 characters","example":"A protective smartphone case with a magnetic ring stand and shockproof corners."},"region":{"type":"string","description":"Country/region code(s) where the product is intended for sale, multiple separated by commas. Currently supports US. Default US","example":"US"},"topNumber":{"type":"integer","description":"Number of results to recall, range: 10--200, default 100","example":10}},"required":["productTitle","productDescription","region","topNumber"],"example":{"topNumber":10,"productDescription":"A protective smartphone case with a magnetic ring stand and shockproof corners.","region":"US","productTitle":"Magnetic phone case with ring stand"},"additionalProperties":true},"example":{"topNumber":10,"productDescription":"A protective smartphone case with a magnetic ring stand and shockproof corners.","region":"US","productTitle":"Magnetic phone case with ring stand"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Record count","example":1},{"type":"null"}]},"detectId":{"anyOf":[{"type":"string","description":"Detection ID","example":"example-id"},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render column definitions","example":[]},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Patent list (see below)","example":[],"items":{"type":"object","properties":{"globalUtilityId":{"type":"string","description":"Patent ID","example":"example-id"},"title":{"type":"string","description":"Utility patent title","example":null},"titleCn":{"type":"string","description":"Utility patent title (Chinese)","example":null},"similarity":{"type":"number","description":"Similarity between the product and this patent (0--1)","example":1},"patentValidity":{"type":"string","description":"Patent validity: Active or Invalid","example":null},"applicationNumber":{"type":"string","description":"Application number","example":null},"applicationDate":{"type":"string","description":"Application date (yyyy-MM-dd)","example":"2026-01-01"},"publicationNumber":{"type":"string","description":"Publication number","example":null},"publicationDate":{"type":"string","description":"Publication date (yyyy-MM-dd)","example":"2026-01-01"},"estimatedDueDate":{"type":"string","description":"Estimated expiration date (yyyy-MM-dd)","example":"2026-01-01"},"region":{"type":"string","description":"Receiving office","example":"US"},"patentAbstract":{"type":"string","description":"Abstract","example":null},"patentAbstractCn":{"type":"string","description":"Abstract (Chinese)","example":null},"claims":{"type":"string","description":"Claims","example":null},"claimsCn":{"type":"string","description":"Claims (Chinese)","example":null},"specification":{"type":"string","description":"Specification","example":null},"specificationCn":{"type":"string","description":"Specification (Chinese)","example":null},"inventors":{"type":"array","description":"Inventors and countries concatenated, array format","example":[]},"inventorAddresses":{"type":"array","description":"Inventor addresses, array format","example":[]},"applicants":{"type":"array","description":"Applicants and countries concatenated, array format","example":[]},"applicantAddresses":{"type":"array","description":"Rights holder addresses, array format","example":[]},"priorityNumber":{"type":"array","description":"Priority numbers, array format","example":[]},"relatedPublicationDate":{"type":"array","description":"First publication dates (yyyy-MM-dd), array format","example":[]},"patentImageUrl":{"type":"string","description":"Patent cover image","example":"https://example.com/image.jpg"},"images":{"type":"array","description":"Patent drawings","example":[]},"classNumList":{"type":"array","description":"Classification number path list, format: classNum1 > classNum2 > classNum3","example":[]},"cpcKindRaw":{"type":"array","description":"CPC classification (raw JSONArray)","example":[]},"troCase":{"type":"boolean","description":"Whether there is a TRO enforcement history","example":false},"troHolder":{"type":"boolean","description":"Whether it is a patent of a TRO rights holder","example":false}}}},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"detectId":"example-id","costToken":1,"columns":[],"data":[{"globalUtilityId":"example-id","similarity":1,"applicationDate":"2026-01-01","publicationDate":"2026-01-01","estimatedDueDate":"2026-01-01","region":"US","inventors":[],"inventorAddresses":[],"applicants":[],"applicantAddresses":[],"priorityNumber":[],"relatedPublicationDate":[],"patentImageUrl":"https://example.com/image.jpg","images":[],"classNumList":[],"cpcKindRaw":[],"troCase":false,"troHolder":false}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"utility-patent-detector","x-nexscope-mcp-tool-name":"nexscope_utility_patent_detector","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/walmart-product-detail/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Walmart Product Detail","description":"Query Walmart product details via Nexscope, including pricing history and sales trends. Trigger when users mention Walmart product detail, Walmart product data, Nexscope, Walmart price trends, Walmart sales trends, Walmart product detail, Walmart price history, Walmart sales trend, Nexscope product. Even if the user does not explicitly mention \"Nexscope\", trigger this skill whenever their need involves viewing detailed information, historical price changes, or sales trends for a single Walmart product.","operationId":"runWalmartProductDetail","externalDocs":{"description":"Walmart Product Detail documentation","url":"https://www.nexscope.ai/api-docs/walmart-product-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.walmart-product-detail.","properties":{"productId":{"type":["integer","string"],"description":"Product ID (ItemId), the numeric ID contained in the product detail link. For example: the 5169493923 in https://www.walmart.com/ip/5169493923","example":"5169493923"},"includeStats":{"type":"boolean","description":"Whether to include historical price/historical sales, default true","example":false}},"required":["productId"],"example":{"includeStats":false,"productId":"5169493923"},"additionalProperties":true},"example":{"includeStats":false,"productId":"5169493923"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of products returned (typically 1 for this endpoint)","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list (see product object below)","example":[],"items":{"type":"object","properties":{"usItemId":{"type":"integer","description":"Internal product ID (same as the requested productId)","example":1},"productId":{"type":"string","description":"Walmart product unique identifier (alphanumeric, e.g., \"6YBM50F6ZXAE\")","example":"example-id"},"title":{"type":"string","description":"Product name","example":null},"description":{"type":"string","description":"Product description","example":null},"price":{"type":"number","description":"Current selling price (USD)","example":1},"wasPrice":{"type":"number","description":"Striketrough price (USD), may be null when no discount","example":1},"minPrice":{"type":"number","description":"Minimum price (USD)","example":1},"brand":{"type":"string","description":"Brand name","example":null},"rating":{"type":"number","description":"Product rating (0.0-5.0)","example":1},"reviews":{"type":"integer","description":"Review count","example":1},"salesEstimate":{"type":"integer","description":"Sales estimate (units, in recent period)","example":1},"revenue":{"type":"number","description":"Revenue estimate (USD)","example":1},"sellerName":{"type":"string","description":"Seller name","example":null},"fulfillmentType":{"type":"string","description":"Fulfillment type: \"MARKETPLACE\" (third-party seller self-fulfilled) or \"WFS\" (Walmart Fulfillment Services)","example":null},"productPageUrl":{"type":"string","description":"Product page URL","example":"https://example.com/image.jpg"},"imageUrl":{"type":"string","description":"Product image URL (thumbnail)","example":"https://example.com/image.jpg"},"departmentName":{"type":"string","description":"Department name (e.g., \"Cell Phones\")","example":null},"departmentId":{"type":"integer","description":"Department ID","example":1},"listingScore":{"type":"integer","description":"Listing quality score","example":1},"contentScore":{"type":"integer","description":"Content quality score","example":1},"outOfStock":{"type":"integer","description":"Whether out of stock (0=in stock, 1=out of stock)","example":1},"sponsored":{"type":"integer","description":"Whether a sponsored product (0=no, 1=yes)","example":1},"isBranded":{"type":"integer","description":"Whether a branded product (0=no, 1=yes)","example":1},"multipleOptionsAvailable":{"type":"integer","description":"Whether there are variants (0=no, 1=yes)","example":1},"createdAt":{"type":"string","description":"First indexed time by Nexscope (format: yyyy-MM-dd'T'HH:mm:ss.SSSSSS'Z')","example":null},"updatedAt":{"type":"string","description":"Most recent data update time (same format as above)","example":"2026-01-01T00:00:00.000000Z"},"stats":{"type":"object","description":"Historical statistics (only returned when includeStats=true, otherwise null. See structure below)","example":{},"properties":{"price":{"type":"array","description":"Historical selling price time series (sorted by date ascending). Each item is a single date-price mapping","example":[]},"sales":{"type":"array","description":"Historical sales time series (sorted by date ascending). Each item is a single date-sales mapping","example":[]}}},"sourceTool":{"type":"string","description":"Source tool identifier","example":null},"sourceType":{"type":"string","description":"Product source platform (fixed value \"walmart\")","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions (metadata describing each field in products, including field, title, cellType, etc.)","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Response render type (fixed value \"productWorkbenches\")","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"API elapsed time (milliseconds)","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"usItemId":1,"productId":"example-id","price":1,"wasPrice":1,"minPrice":1,"rating":1,"reviews":1,"salesEstimate":1,"revenue":1,"productPageUrl":"https://example.com/image.jpg","imageUrl":"https://example.com/image.jpg","departmentId":1,"listingScore":1,"contentScore":1,"outOfStock":1,"sponsored":1,"isBranded":1,"multipleOptionsAvailable":1,"updatedAt":"2026-01-01T00:00:00.000000Z","stats":{"price":[],"sales":[]}}],"columns":[],"costTime":1,"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"walmart-product-detail","x-nexscope-mcp-tool-name":"nexscope_walmart_product_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/walmart-search/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Walmart Search","description":"Search and browse Walmart product listings by keyword, category, price range, and other conditions. Trigger when users mention Walmart product search, Walmart product listing, Walmart price comparison, Walmart competitor analysis, Walmart product research, Walmart market data, find products on Walmart, Walmart search, Walmart products, Walmart product selection, Walmart pricing, Walmart competitors, Walmart market. Even if the user does not explicitly mention \"Walmart search\", trigger this skill whenever their need involves searching for products on Walmart, checking product availability, comparing Walmart prices, or analyzing Walmart product listings.","operationId":"runWalmartSearch","externalDocs":{"description":"Walmart Search documentation","url":"https://www.nexscope.ai/api-docs/walmart-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.walmart-search.","properties":{"keyword":{"type":"string","description":"Search keyword, max length 1024 characters. *At least one of keyword and categoryId must be provided","example":"phone case"},"categoryId":{"type":"string","description":"Category ID. *At least one of keyword and categoryId must be provided. 0 means all departments. For example: 976759_976787 means \"Cookies\"","example":"976759_976787"},"sort":{"type":"string","description":"Sort method. Options: price_low (price low to high), price_high (price high to low), best_seller (best seller), best_match (best match)"},"page":{"type":"integer","description":"Page number for pagination, default 1, max 100","example":1},"minPrice":{"type":"number","description":"Minimum price","example":1},"maxPrice":{"type":"number","description":"Maximum price","example":1},"spelling":{"type":"boolean","description":"Enable spelling correction, default true. true includes spelling correction, false excludes it","example":false},"softSort":{"type":"boolean","description":"Sort by relevance, default true. Set to false to disable relevance sorting","example":false},"storeId":{"type":"string","description":"Store ID, used to filter products by a specific store","example":"example-id"},"device":{"type":"string","description":"Device type, default desktop. Options: desktop, tablet, mobile"},"facet":{"type":"string","description":"Filter conditions, format as key:value pairs separated by \\"},"nextDayEnabled":{"type":"boolean","description":"Only show NextDay delivery results, default false. true to enable, false to disable","example":false},"jsonRestrictor":{"type":"string","description":"JSON field restrictor"}},"example":{"page":1,"keyword":"phone case","spelling":true},"additionalProperties":true},"example":{"page":1,"keyword":"phone case","spelling":true}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Record count","example":1},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Product list (see product object below)","example":[],"items":{"type":"object","properties":{"productId":{"type":"string","description":"Product ID","example":"example-id"},"usItemId":{"type":"string","description":"US item ID","example":"example-id"},"title":{"type":"string","description":"Title","example":null},"description":{"type":"string","description":"Description","example":null},"price":{"type":"number","description":"Price","example":1},"wasPrice":{"type":"number","description":"Original price (was_price)","example":1},"currency":{"type":"string","description":"Currency unit","example":null},"minPrice":{"type":"number","description":"Minimum price","example":1},"pricePerUnitAmount":{"type":"string","description":"Price per unit amount","example":null},"pricePerUnit":{"type":"string","description":"Price per unit","example":null},"rating":{"type":"number","description":"Rating","example":1},"reviews":{"type":"integer","description":"Review count","example":1},"sellerName":{"type":"string","description":"Seller name","example":null},"sellerId":{"type":"string","description":"Seller ID","example":"example-id"},"imageUrl":{"type":"string","description":"Thumbnail","example":"https://example.com/image.jpg"},"productPageUrl":{"type":"string","description":"Product page URL","example":"https://example.com/image.jpg"},"sponsored":{"type":"boolean","description":"Whether a sponsored product","example":false},"outOfStock":{"type":"boolean","description":"Whether out of stock","example":false},"freeShipping":{"type":"boolean","description":"Whether free shipping","example":false},"twoDayShipping":{"type":"boolean","description":"Whether two-day shipping supported","example":false},"freeShippingWithWalmartPlus":{"type":"boolean","description":"Free shipping for Walmart Plus members","example":false},"shippingPrice":{"type":"number","description":"Shipping cost","example":1},"multipleOptionsAvailable":{"type":"boolean","description":"Whether multiple options available","example":false},"variantSwatches":{"type":"array","description":"Variant swatch list (each item contains name variant name, imageUrl variant image URL, productPageUrl variant product page URL, variantFieldId variant field ID)","example":[]},"sourceTool":{"type":"string","description":"Source tool","example":null},"sourceType":{"type":"string","description":"Source type: walmart","example":null}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"productId":"example-id","usItemId":"example-id","price":1,"wasPrice":1,"minPrice":1,"rating":1,"reviews":1,"sellerId":"example-id","imageUrl":"https://example.com/image.jpg","productPageUrl":"https://example.com/image.jpg","sponsored":false,"outOfStock":false,"freeShipping":false,"twoDayShipping":false,"freeShippingWithWalmartPlus":false,"shippingPrice":1,"multipleOptionsAvailable":false,"variantSwatches":[]}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"walmart-search","x-nexscope-mcp-tool-name":"nexscope_walmart_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/amazon-alexa-search/run":{"post":{"tags":["Amazon Marketplace Intelligence"],"summary":"Amazon Alexa Search","description":"Initiate natural language Q&A through Amazon's storefront Alexa shopping assistant to get shopping guidance answers, recommended product groups, ASIN lists, and follow-up questions. Each call supports only 1 prompt; for follow-ups, the agent must summarize context and concatenate a new question for a new request. A url can be used to supplement Amazon page context. Trigger when the user mentions Amazon Alexa, Alexa shopping assistant, Amazon smart assistant, AI shopping guide, conversational product selection, natural language shopping, Amazon chat Q&A, Amazon Alexa shopping, conversational shopping, AI shopping assistant, follow-up questions, product recommendation conversation, context follow-ups. Even if the user does not explicitly mention \"Alexa\", if their need is to \"ask for product recommendations on Amazon using natural language\", this skill should also be triggered.","operationId":"runAmazonAlexaSearch","externalDocs":{"description":"Amazon Alexa Search documentation","url":"https://www.nexscope.ai/api-docs/amazon-alexa-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.amazon-alexa-search.","properties":{"prompts":{"type":"array","items":{"type":"string"},"description":"Conversation prompt array, supports only 1 entry. Each call accepts only 1 question. For follow-up questions, the agent must summarize key information from the previous response (recommended products, ASINs, key conclusions, etc.), concatenate it with the new question, and send it as a new prompts[0]. Each call is an independent new session and does not retain cross-call conversation history","example":["What are good phone cases for iPhone?"]},"format":{"type":"string","description":"Response format: markdown (default) returns a readable report; json returns a structured data array"},"url":{"type":"string","description":"Linked page URL, used to supplement the page context of Alexa's current response. Only pass this when the user provides a specific page (category page / search results page / product detail page, etc.); do not pass this parameter for the Amazon homepage (e.g. https://www.amazon.com/)","example":"https://example.com/image.jpg"}},"required":["prompts"],"example":{"prompts":["What are good phone cases for iPhone?"],"format":"markdown"},"additionalProperties":true},"example":{"prompts":["What are good phone cases for iPhone?"],"format":"markdown"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"array","description":"Structured conversation result array; only returned when format=json","example":[],"items":{"type":"object","properties":{"stdout":{"anyOf":[{"type":"string","description":"Markdown format Q&A report, containing each round's user question, Alexa answer, recommended products, and follow-up questions; only returned when format=markdown","example":null},{"type":"null"}]},"prompt":{"type":"string","description":"Prompt sent to Alexa for this round","example":null},"content":{"type":"string","description":"Text content of Alexa's response for this round","example":null},"screenshot":{"type":"string","description":"Screenshot link for this round's conversation","example":null},"followUpQuestions":{"type":"array","description":"List of follow-up questions recommended by Alexa","example":[]},"products":{"type":"array","description":"Recommended product group list, each group containing title and items","example":[],"items":{"type":"object","properties":{"title":{"type":"string","description":"Recommended group title","example":null},"items":{"type":"array","items":{"type":"object","properties":{"asin":{"type":"string","description":"Product ASIN","example":"B072MQ5BRX"},"title":{"type":"string","description":"Product title","example":null},"url":{"type":"string","description":"Product detail page URL","example":"https://www.amazon.com/dp/B072MQ5BRX"},"cover":{"type":"string","description":"Product cover image URL","example":null},"price":{"type":"string","description":"Current price (with currency)","example":null},"originalPrice":{"type":"string","description":"Original or strikethrough price","example":null},"score":{"type":"string","description":"Rating","example":null},"ratingsCount":{"type":"string","description":"Review count","example":null},"describe":{"type":"string","description":"Product description","example":null}}}}}}}}}},{"type":"null"}]},"resultsNum":{"anyOf":[{"type":"integer","description":"Number of conversation rounds Alexa actually answered; 0 means no valid response was produced","example":1},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"API latency in milliseconds","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed by this call; charged only if upstream succeeds","example":1},{"type":"null"}]},"taskId":{"anyOf":[{"type":"string","description":"Task identifier returned by upstream","example":"example-id"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style: stdoutWorkbenches (markdown) or json","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"data":[{"followUpQuestions":[],"products":[{"items":[{"asin":"B072MQ5BRX","url":"https://www.amazon.com/dp/B072MQ5BRX"}]}]}],"resultsNum":1,"costTime":1,"costToken":1,"taskId":"example-id"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"amazon-alexa-search","x-nexscope-mcp-tool-name":"nexscope_amazon_alexa_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/web-search/run":{"post":{"tags":["Search & Trend Intelligence"],"summary":"Web Search","description":"Web search, online retrieval, real-time information query, search engine search, Reddit and other community platform discussions, external site posts and trending topics. Trigger when users need to search for the latest information online, look up recent news or trends, query real-time data, research topics via search engines, browse Reddit or community discussions, discover external site posts and trending topics, obtain any online content, web search, online lookup, real-time information, news search, Reddit, trending topics, search engine. Even if the user does not explicitly say \"search\", trigger this skill whenever their intent involves obtaining real-time web information or verifying current facts.","operationId":"runWebSearch","externalDocs":{"description":"Web Search documentation","url":"https://www.nexscope.ai/api-docs/web-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.web-search.","properties":{"keyword":{"type":"string","description":"Search keyword, max length 1000 characters","example":"phone case"}},"required":["keyword"],"example":{"keyword":"phone case"},"additionalProperties":true},"example":{"keyword":"phone case"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"searchList":{"anyOf":[{"type":"array","description":"Search result list","example":[],"items":{"type":"object","properties":{"score":{"type":"number","description":"Result relevance score","example":1},"title":{"type":"string","description":"Page title","example":null},"url":{"type":"string","description":"Page link","example":"https://example.com/image.jpg"},"content":{"type":"string","description":"Extracted page content","example":null}}}},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost","example":1},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"searchList":[{"score":1,"url":"https://example.com/image.jpg"}],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"web-search","x-nexscope-mcp-tool-name":"nexscope_web_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/zhihuiya-patent-image-search/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Nexscope Patent Image Search","description":"Perform visual similarity search for design patents using an image URL, with filtering by country, legal status, date ranges, Locarno classification, and assignee. Supports design patent types only (type D). Triggered when users mention patent image search, design patent search, search patent by image, visual patent lookup, patent similarity detection, patent image matching, or design patent infringement check. Even if the user does not explicitly mention \"patent image,\" this skill should be triggered whenever the need involves searching for similar design patents through an image. For utility model patents, use ecommerce.zhihuiya-utility-patent-image-search instead.","operationId":"runZhihuiyaPatentImageSearch","externalDocs":{"description":"Nexscope Patent Image Search documentation","url":"https://www.nexscope.ai/api-docs/zhihuiya-patent-image-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request parameters documented by ecommerce.zhihuiya-patent-image-search.","properties":{"url":{"type":"string","description":"Image URL (maximum 1,000 characters)","example":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg"},"patentType":{"type":"string","description":"Patent type: D for a design patent or U for a utility model patent. Default: D","example":"D"},"model":{"type":"integer","description":"Image-search model. Design patents: 1 (smart association, recommended) or 2 (search this image). Utility model patents: 3 (match shape) or 4 (match shape, pattern, and color; recommended)","example":1},"country":{"type":"string","description":"Patent authority codes for countries, organizations, or regions, separated by commas, for example CN,US,JP. Omit to search all patent authorities"},"loc":{"type":"string","description":"LOC classifications (Locarno classification numbers). Join multiple classifications with AND, OR, or NOT"},"legalStatus":{"type":"string","description":"Comma-separated patent legal-status codes. Values: 1 (published), 2 (substantive examination), 3 (granted), 8 (duplicate-grant avoidance), 11 (withdrawn), 12 (withdrawn-unspecified), 17 (deemed withdrawn), 18 (voluntarily withdrawn), 13 (rejected), 14 (fully revoked), 15 (expired), 16 (annual fee unpaid), 21 (rights restored), 22 (rights terminated), 23 (partially invalid), 24 (application terminated), 30 (abandoned), 19 (deemed abandoned), 20 (voluntarily abandoned), 25 (abandoned-unspecified), 222 (PCT did not enter designated state within designation period), 223 (PCT entered designated state within designation period), 224 (PCT entered designated state after designation period), and 225 (PCT did not enter designated state after designation period)"},"simpleLegalStatus":{"type":"string","description":"Comma-separated simplified patent legal-status codes. Values: 0 (inactive), 1 (active), 2 (pending), 220 (PCT designation period expired), 221 (within PCT designation period), and 999 (unconfirmed)"},"assignees":{"type":"string","description":"Applicant or patent owner (maximum 1,000 characters)"},"applyStartTime":{"type":"string","description":"Patent application start date in yyyyMMdd format"},"applyEndTime":{"type":"string","description":"Patent application end date in yyyyMMdd format"},"publicStartTime":{"type":"string","description":"Patent publication start date in yyyyMMdd format"},"publicEndTime":{"type":"string","description":"Patent publication end date in yyyyMMdd format"},"limit":{"type":"integer","description":"Number of patents to return, from 1 to 100. Default: 10","example":5},"offset":{"type":"integer","description":"Result offset, from 0 to 1,000. Default: 0","example":0},"field":{"type":"string","description":"Result sort field: SCORE (relevance), APD (application date), PBD (publication date), or ISD (grant date). Default: SCORE"},"order":{"type":"string","description":"Available when field is APD, PBD, or ISD: desc (descending) or asc (ascending). Default: desc"},"lang":{"type":"string","description":"Preferred title language: original (original patent title), cn (Chinese-translated title), or en (English-translated title). Default: original"},"preFilter":{"type":"integer","description":"Whether to enable country/LOC pre-filtering: 1 for enabled and 0 for disabled. Default: 1","example":1},"stemming":{"type":"integer","description":"Whether to enable stemming: 1 for enabled and 0 for disabled. Default: 0","example":0},"mainField":{"type":"string","description":"Primary patent fields, including title, abstract, claims, specification, publication number, application number, applicant, inventor, and IPC/UPC/LOC classifications (maximum 1,000 characters)"},"includeMachineTranslation":{"type":"boolean","description":"Include machine-translated data in the search","example":false},"scoreExpansion":{"type":"boolean","description":"Score expansion","example":false},"isHttps":{"type":"integer","description":"Whether to return images over HTTPS: 1 for HTTPS and 0 for HTTP. Default: 0","example":1},"returnImgId":{"type":"boolean","description":"Whether to return img_id. Default: false","example":false}},"required":["url","patentType","model"],"example":{"country":"US","url":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg","patentType":"D","model":1,"preFilter":1,"isHttps":1,"limit":5,"stemming":0,"offset":0},"additionalProperties":true},"example":{"country":"US","url":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg","patentType":"D","model":1,"preFilter":1,"isHttps":1,"limit":5,"stemming":0,"offset":0}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records returned in this response","example":1},{"type":"null"}]},"allRecordsCount":{"anyOf":[{"type":"integer","description":"Total number of matching records in the database","example":1},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Matching patent records","example":[],"items":{"type":"object","properties":{"patentId":{"type":"string","description":"Similar patent ID","example":"example-id"},"patentPn":{"type":"string","description":"Similar patent number","example":null},"apno":{"type":"string","description":"Application number","example":null},"title":{"type":"string","description":"Patent title","example":null},"inventor":{"type":"string","description":"Inventor","example":null},"originalAssignee":{"type":"string","description":"Original assignee","example":null},"currentAssignee":{"type":"string","description":"Current assignee","example":null},"authority":{"type":"string","description":"Patent authority (country code)","example":null},"url":{"type":"string","description":"URL of the similar patent drawing","example":"https://example.com/image.jpg"},"score":{"type":"number","description":"Similarity score; higher values indicate greater similarity. Available only when field is SCORE","example":1},"loc":{"type":"array","description":"LOC classification (Locarno classification number)","example":[]},"locMatch":{"type":"integer","description":"Whether a high-weight LOC class matched: 1 for matched and 0 for not matched. Available only when model=1 and field=SCORE","example":1},"apdt":{"type":"integer","description":"Application date (timestamp)","example":1},"pbdt":{"type":"integer","description":"Publication date (timestamp)","example":1},"imgId":{"type":"string","description":"Patent drawing img_id, returned only when returnImgId is true","example":"example-id"}}}},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Column definitions used for rendering","example":[]},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendering style","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Tokens consumed","example":1},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"allRecordsCount":1,"data":[{"patentId":"example-id","url":"https://example.com/image.jpg","score":1,"loc":[],"locMatch":1,"apdt":1,"pbdt":1,"imgId":"example-id"}],"columns":[],"costToken":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"zhihuiya-patent-image-search","x-nexscope-mcp-tool-name":"nexscope_zhihuiya_patent_image_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ai-model-swap/run":{"post":{"tags":["Multimodal AI"],"summary":"AI Model Swap API","description":"Generate model images by combining a source product image with a model head image, optional masks, scene references, and prompt guidance.","operationId":"runAiModelSwap","externalDocs":{"description":"AI Model Swap API documentation","url":"https://www.nexscope.ai/api-docs/ai-model-swap"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate model images by combining a source product image with a model head image, optional masks, scene references, and prompt guidance.","properties":{"imageUrl":{"type":"string","description":"Public URL of the source product or outfit image. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height.","example":"https://example.com/source-image.jpg"},"modelHeadImageUrl":{"type":"string","description":"Public URL of the target model head image. The image must be up to 5 MB and between 512 and 2048 pixels in both width and height.","example":"https://example.com/model-reference.jpg"},"imageSegUrl":{"type":"string","description":"Optional segmentation mask URL for the source image.","example":"https://example.com/mask.png"},"sceneImgUrl":{"type":"string","description":"Optional scene reference image URL. The image must be up to 10 MB and between 768 and 4096 pixels in both width and height.","example":"https://example.com/scene.jpg"},"sceneStrength":{"type":"number","description":"Scene reference strength from 0 to 1. Defaults to 0.7.","example":0.7},"modelPrompt":{"type":"string","description":"Comma-separated model appearance terms, such as smile, laugh, sitting, lying, fat, plump, slim, sideways, profile, back, or bald.","example":"smile, slim"},"customPrompt":{"type":"string","description":"Positive generation prompt, up to 600 characters.","example":"clean ecommerce catalog photo"},"customNegPrompt":{"type":"string","description":"Negative prompt to avoid unwanted artifacts.","example":"blur, distorted hands"},"genOriRes":{"type":"boolean","description":"Whether to generate the original resolution. Defaults to false.","example":false},"realModel":{"type":"boolean","description":"Whether to prefer a realistic model style.","example":true},"outputNum":{"type":"integer","description":"Number of images to generate, from 1 to 4. Defaults to 1.","example":1}},"required":["imageUrl","modelHeadImageUrl"],"example":{"imageUrl":"https://example.com/source-image.jpg","modelHeadImageUrl":"https://example.com/model-reference.jpg","imageSegUrl":"https://example.com/mask.png","sceneImgUrl":"https://example.com/scene.jpg","sceneStrength":0.7,"modelPrompt":"smile, slim","customPrompt":"clean ecommerce catalog photo","customNegPrompt":"blur, distorted hands","genOriRes":false,"realModel":true,"outputNum":1},"additionalProperties":true},"example":{"imageUrl":"https://example.com/source-image.jpg","modelHeadImageUrl":"https://example.com/model-reference.jpg","imageSegUrl":"https://example.com/mask.png","sceneImgUrl":"https://example.com/scene.jpg","sceneStrength":0.7,"modelPrompt":"smile, slim","customPrompt":"clean ecommerce catalog photo","customNegPrompt":"blur, distorted hands","genOriRes":false,"realModel":true,"outputNum":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ai-model-swap","x-nexscope-mcp-tool-name":"nexscope_ai_model_swap","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ai-model-swap-2-0/run":{"post":{"tags":["Multimodal AI"],"summary":"AI Model Swap API 2.0","description":"Generate model images from a product image and a full model reference image with optional segmentation and scene controls.","operationId":"runAiModelSwap20","externalDocs":{"description":"AI Model Swap API 2.0 documentation","url":"https://www.nexscope.ai/api-docs/ai-model-swap-2-0"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate model images from a product image and a full model reference image with optional segmentation and scene controls.","properties":{"imageUrl":{"type":"string","description":"Public URL of the source product or outfit image. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height.","example":"https://example.com/source-image.jpg"},"modelImageUrl":{"type":"string","description":"Public URL of the full model reference image.","example":"https://example.com/model-reference.jpg"},"outputNum":{"type":"integer","description":"Number of images to generate, from 1 to 4. Defaults to 1.","example":1},"imageSegUrl":{"type":"string","description":"Optional segmentation mask URL for the source image.","example":"https://example.com/mask.png"},"sceneImgUrl":{"type":"string","description":"Optional scene reference image URL.","example":"https://example.com/scene.jpg"},"sceneStrength":{"type":"number","description":"Scene reference strength from 0 to 1. Defaults to 0.7.","example":0.7},"genOriRes":{"type":"boolean","description":"Whether to generate the original resolution. Defaults to false.","example":false},"realModel":{"type":"boolean","description":"Whether to prefer a realistic model style.","example":true}},"required":["imageUrl","modelImageUrl"],"example":{"imageUrl":"https://example.com/source-image.jpg","modelImageUrl":"https://example.com/model-reference.jpg","outputNum":1,"imageSegUrl":"https://example.com/mask.png","sceneImgUrl":"https://example.com/scene.jpg","sceneStrength":0.7,"genOriRes":false,"realModel":true},"additionalProperties":true},"example":{"imageUrl":"https://example.com/source-image.jpg","modelImageUrl":"https://example.com/model-reference.jpg","outputNum":1,"imageSegUrl":"https://example.com/mask.png","sceneImgUrl":"https://example.com/scene.jpg","sceneStrength":0.7,"genOriRes":false,"realModel":true}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ai-model-swap-2-0","x-nexscope-mcp-tool-name":"nexscope_ai_model_swap_2_0","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ai-model-scene-background-replacement/run":{"post":{"tags":["Multimodal AI"],"summary":"AI Model Scene & Background Replacement API","description":"Generate scene variants for a model image using either a scene reference image or a text scene prompt.","operationId":"runAiModelSceneBackgroundReplacement","externalDocs":{"description":"AI Model Scene & Background Replacement API documentation","url":"https://www.nexscope.ai/api-docs/ai-model-scene-background-replacement"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate scene variants for a model image using either a scene reference image or a text scene prompt.","properties":{"imageUrl":{"type":"string","description":"Public URL of the model image. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height.","example":"https://example.com/model-reference.jpg"},"sceneImgUrl":{"type":"string","description":"Optional public URL of the target scene reference.","example":"https://example.com/scene.jpg"},"scenePrompt":{"type":"string","description":"Optional text prompt describing the target scene.","example":"bright studio showroom"},"imageSegUrl":{"type":"string","description":"Optional model segmentation mask URL.","example":"https://example.com/mask.png"},"sceneStrength":{"type":"number","description":"Scene reference strength from 0 to 1. Defaults to 0.7.","example":0.7},"genOriRes":{"type":"boolean","description":"Whether to generate the original resolution. Defaults to false.","example":false},"realModel":{"type":"boolean","description":"Whether to prefer realistic model rendering.","example":true},"outputNum":{"type":"integer","description":"Number of images to generate, from 1 to 4. Defaults to 1.","example":1}},"required":["imageUrl"],"example":{"imageUrl":"https://example.com/model-reference.jpg","scenePrompt":"bright studio showroom","sceneStrength":0.7,"genOriRes":false,"realModel":true,"outputNum":1},"additionalProperties":true},"example":{"imageUrl":"https://example.com/model-reference.jpg","scenePrompt":"bright studio showroom","sceneStrength":0.7,"genOriRes":false,"realModel":true,"outputNum":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ai-model-scene-background-replacement","x-nexscope-mcp-tool-name":"nexscope_ai_model_scene_background_replacement","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ai-clothes-changer-for-tops-bottoms/run":{"post":{"tags":["Multimodal AI"],"summary":"AI Clothes Changer API for Tops & Bottoms","description":"Dress a model image with upper and/or lower garment assets, supporting optional masks and original garment references.","operationId":"runAiClothesChangerForTopsBottoms","externalDocs":{"description":"AI Clothes Changer API for Tops & Bottoms documentation","url":"https://www.nexscope.ai/api-docs/ai-clothes-changer-for-tops-bottoms"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Dress a model image with upper and/or lower garment assets, supporting optional masks and original garment references.","properties":{"modelImageUrl":{"type":"string","description":"Public URL of the model image.","example":"https://example.com/model-reference.jpg"},"upperOriginUrl":{"type":"string","description":"Public URL of the original upper garment image. The image must be up to 20 MB and between 385 and 4096 pixels in both width and height.","example":"https://example.com/top.jpg"},"downOriginUrl":{"type":"string","description":"Public URL of the original lower garment image. The image must be up to 20 MB and between 385 and 4096 pixels in both width and height.","example":"https://example.com/bottom.jpg"},"upperImageUrl":{"type":"string","description":"Optional processed upper garment mask or crop URL.","example":"https://example.com/top-mask.png"},"downImageUrl":{"type":"string","description":"Optional processed lower garment mask or crop URL.","example":"https://example.com/bottom-mask.png"},"modelMaskImageUrl":{"type":"string","description":"Optional mask URL for the model body area.","example":"https://example.com/mask.png"},"outputNum":{"type":"integer","description":"Number of images to generate, from 1 to 4. Defaults to 1.","example":1}},"required":["modelImageUrl"],"example":{"modelImageUrl":"https://example.com/model-reference.jpg","upperOriginUrl":"https://example.com/top.jpg","downOriginUrl":"https://example.com/bottom.jpg","upperImageUrl":"https://example.com/top-mask.png","downImageUrl":"https://example.com/bottom-mask.png","modelMaskImageUrl":"https://example.com/mask.png","outputNum":1},"additionalProperties":true},"example":{"modelImageUrl":"https://example.com/model-reference.jpg","upperOriginUrl":"https://example.com/top.jpg","downOriginUrl":"https://example.com/bottom.jpg","upperImageUrl":"https://example.com/top-mask.png","downImageUrl":"https://example.com/bottom-mask.png","modelMaskImageUrl":"https://example.com/mask.png","outputNum":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ai-clothes-changer-for-tops-bottoms","x-nexscope-mcp-tool-name":"nexscope_ai_clothes_changer_for_tops_bottoms","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ai-suit-virtual-try-on/run":{"post":{"tags":["Multimodal AI"],"summary":"AI Suit Virtual Try-On API","description":"Dress a model image with a one-piece outfit or suit image, supporting optional garment and model masks.","operationId":"runAiSuitVirtualTryOn","externalDocs":{"description":"AI Suit Virtual Try-On API documentation","url":"https://www.nexscope.ai/api-docs/ai-suit-virtual-try-on"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Dress a model image with a one-piece outfit or suit image, supporting optional garment and model masks.","properties":{"suitOriginUrl":{"type":"string","description":"Public URL of the original one-piece garment image. The image must be up to 20 MB and between 385 and 4096 pixels in both width and height.","example":"https://example.com/suit.jpg"},"modelImageUrl":{"type":"string","description":"Public URL of the model image.","example":"https://example.com/model-reference.jpg"},"suitImageUrl":{"type":"string","description":"Optional processed suit mask or crop URL.","example":"https://example.com/suit-mask.png"},"modelMaskImageUrl":{"type":"string","description":"Optional mask URL for the model body area.","example":"https://example.com/mask.png"},"outputNum":{"type":"integer","description":"Number of images to generate, from 1 to 4. Defaults to 1.","example":1}},"required":["suitOriginUrl","modelImageUrl"],"example":{"suitOriginUrl":"https://example.com/suit.jpg","modelImageUrl":"https://example.com/model-reference.jpg","suitImageUrl":"https://example.com/suit-mask.png","modelMaskImageUrl":"https://example.com/mask.png","outputNum":1},"additionalProperties":true},"example":{"suitOriginUrl":"https://example.com/suit.jpg","modelImageUrl":"https://example.com/model-reference.jpg","suitImageUrl":"https://example.com/suit-mask.png","modelMaskImageUrl":"https://example.com/mask.png","outputNum":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ai-suit-virtual-try-on","x-nexscope-mcp-tool-name":"nexscope_ai_suit_virtual_try_on","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/virtual-try-on/run":{"post":{"tags":["Multimodal AI"],"summary":"Virtual Try-On API","description":"Generate wearable-product imagery from a source person image and target product image.","operationId":"runVirtualTryOn","externalDocs":{"description":"Virtual Try-On API documentation","url":"https://www.nexscope.ai/api-docs/virtual-try-on"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate wearable-product imagery from a source person image and target product image.","properties":{"imageUrl":{"type":"string","description":"Public URL of the wearable product image. The image must be between 300 and 4096 pixels in both width and height. The width-to-height ratio must be between 0.4 and 2.5.","example":"https://example.com/product.jpg"},"targetOriginUrl":{"type":"string","description":"Public URL of the person or model image.","example":"https://example.com/model-reference.jpg"},"targetMaskUrl":{"type":"string","description":"Public URL of the black-and-white target wear-area mask. Required because this API accepts custom target images rather than saved upstream materials.","example":"https://example.com/mask.png"},"productCategory":{"type":"string","description":"Product category. Supported values: footwear (shoes), luggage (bags), eyewear (glasses), necklace, hat, earring, ring, wristband, watch, headwear, belt, other.","example":"hat"},"outputNum":{"type":"integer","description":"Number of images to generate, from 1 to 4. Defaults to 1.","example":1}},"required":["imageUrl","targetOriginUrl","targetMaskUrl"],"example":{"imageUrl":"https://example.com/product.jpg","targetOriginUrl":"https://example.com/model-reference.jpg","targetMaskUrl":"https://example.com/mask.png","productCategory":"hat","outputNum":1},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg","targetOriginUrl":"https://example.com/model-reference.jpg","targetMaskUrl":"https://example.com/mask.png","productCategory":"hat","outputNum":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"virtual-try-on","x-nexscope-mcp-tool-name":"nexscope_virtual_try_on","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/product-replacement/run":{"post":{"tags":["Multimodal AI"],"summary":"Product Replacement API","description":"Use source and target product references to replace product content while preserving scene consistency.","operationId":"runProductReplacement","externalDocs":{"description":"Product Replacement API documentation","url":"https://www.nexscope.ai/api-docs/product-replacement"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Use source and target product references to replace product content while preserving scene consistency.","properties":{"imageUrl":{"type":"string","description":"Public URL of the base image. The image must be up to 20 MB and between 384 and 8192 pixels in both width and height.","example":"https://example.com/source-image.jpg"},"targetOriginUrl":{"type":"string","description":"Public URL of the replacement product image.","example":"https://example.com/product.jpg"},"sourceImageUrl":{"type":"string","description":"Optional source product crop URL.","example":"https://example.com/source-product.jpg"},"targetImageUrl":{"type":"string","description":"Optional processed replacement product URL.","example":"https://example.com/target-product.png"},"denoiseStrength":{"type":"number","description":"Generation denoise strength from 0 to 1. Defaults to 0.5.","example":0.5},"imageOutputWidth":{"type":"integer","description":"Desired output width in pixels, from 32 to 4096.","example":1024},"imageOutputHeight":{"type":"integer","description":"Desired output height in pixels, from 32 to 4096.","example":1024},"outputNum":{"type":"integer","description":"Number of images to generate, from 1 to 4. Defaults to 1.","example":1}},"required":["imageUrl","targetOriginUrl"],"example":{"imageUrl":"https://example.com/source-image.jpg","targetOriginUrl":"https://example.com/product.jpg","sourceImageUrl":"https://example.com/source-product.jpg","targetImageUrl":"https://example.com/target-product.png","denoiseStrength":0.5,"imageOutputWidth":1024,"imageOutputHeight":1024,"outputNum":1},"additionalProperties":true},"example":{"imageUrl":"https://example.com/source-image.jpg","targetOriginUrl":"https://example.com/product.jpg","sourceImageUrl":"https://example.com/source-product.jpg","targetImageUrl":"https://example.com/target-product.png","denoiseStrength":0.5,"imageOutputWidth":1024,"imageOutputHeight":1024,"outputNum":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"product-replacement","x-nexscope-mcp-tool-name":"nexscope_product_replacement","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/product-scene-variations/run":{"post":{"tags":["Multimodal AI"],"summary":"Product Scene Variations API","description":"Generate multiple ecommerce scene variants from a product image, optional segmentation, and prompt guidance.","operationId":"runProductSceneVariations","externalDocs":{"description":"Product Scene Variations API documentation","url":"https://www.nexscope.ai/api-docs/product-scene-variations"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate multiple ecommerce scene variants from a product image, optional segmentation, and prompt guidance.","properties":{"imageUrl":{"type":"string","description":"Public URL of the product image. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height.","example":"https://example.com/product.jpg"},"segImageUrl":{"type":"string","description":"Optional segmentation mask URL.","example":"https://example.com/mask.png"},"strength":{"type":"number","description":"Variation strength from 0.1 to 1. Defaults to 0.5.","example":0.5},"prompt":{"type":"string","description":"Scene generation prompt, up to 600 characters.","example":"modern kitchen countertop"},"imageOutputWidth":{"type":"integer","description":"Desired output width in pixels, from 32 to 2048.","example":1024},"imageOutputHeight":{"type":"integer","description":"Desired output height in pixels, from 32 to 2048.","example":1024},"outputNum":{"type":"integer","description":"Number of images to generate, from 1 to 4.","example":1}},"required":["imageUrl"],"example":{"imageUrl":"https://example.com/product.jpg","segImageUrl":"https://example.com/mask.png","strength":0.5,"prompt":"modern kitchen countertop","imageOutputWidth":1024,"imageOutputHeight":1024,"outputNum":1},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg","segImageUrl":"https://example.com/mask.png","strength":0.5,"prompt":"modern kitchen countertop","imageOutputWidth":1024,"imageOutputHeight":1024,"outputNum":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"product-scene-variations","x-nexscope-mcp-tool-name":"nexscope_product_scene_variations","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ai-background-generator/run":{"post":{"tags":["Multimodal AI"],"summary":"AI Background Generator API","description":"Create product or lifestyle scene images from text prompts and optional reference images.","operationId":"runAiBackgroundGenerator","externalDocs":{"description":"AI Background Generator API documentation","url":"https://www.nexscope.ai/api-docs/ai-background-generator"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Create product or lifestyle scene images from text prompts and optional reference images.","properties":{"prompt":{"type":"string","description":"Text prompt describing the desired scene.","example":"a premium phone case on a clean marble desk"},"imageUrl":{"type":"string","description":"Optional reference image URL.","example":"https://example.com/product.jpg"},"style":{"type":"string","description":"Style preset. Supported values: scene-material, portrait-material, ancient-chinese, expressive-sketch, cyberpunk, pixel-illustration, tranquil-ink, anime-line-art, makoto-shinkai, hayao-miyazaki, cg, monochrome-illustration, retro-anime, chibi-character, realistic-oil-painting, c4d-paper-cut, expressive-watercolor, fresh-anime.","example":"scene-material"},"scale":{"type":"string","description":"Output aspect ratio. Supported values: 1:1, 16:9, 9:16. Defaults to 1:1.","example":"1:1"},"outputNum":{"type":"integer","description":"Number of images to generate, from 1 to 4. Defaults to 4.","example":4}},"required":["prompt"],"example":{"prompt":"a premium phone case on a clean marble desk","imageUrl":"https://example.com/product.jpg","style":"scene-material","scale":"1:1","outputNum":4},"additionalProperties":true},"example":{"prompt":"a premium phone case on a clean marble desk","imageUrl":"https://example.com/product.jpg","style":"scene-material","scale":"1:1","outputNum":4}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ai-background-generator","x-nexscope-mcp-tool-name":"nexscope_ai_background_generator","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/similar-image-variations/run":{"post":{"tags":["Multimodal AI"],"summary":"Similar Image Variations API","description":"Generate similar ecommerce images from a reference image with optional prompt and strength controls.","operationId":"runSimilarImageVariations","externalDocs":{"description":"Similar Image Variations API documentation","url":"https://www.nexscope.ai/api-docs/similar-image-variations"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate similar ecommerce images from a reference image with optional prompt and strength controls.","properties":{"imageUrl":{"type":"string","description":"Public URL of a JPG, PNG, or WEBP reference image up to 10 MB and at most 4096 pixels in both width and height.","example":"https://example.com/product.jpg"},"prompt":{"type":"string","description":"Optional prompt for the desired variation, up to 600 characters.","example":"same product, brighter background"},"weight":{"type":"integer","description":"Reference image weight from 0 to 2. Defaults to 2.","example":2},"width":{"type":"integer","description":"Desired output width in pixels, from 384 to 4096.","example":1024,"minimum":384,"maximum":4096},"height":{"type":"integer","description":"Desired output height in pixels, from 384 to 4096.","example":1024,"minimum":384,"maximum":4096},"scale":{"type":"string","description":"Optional aspect ratio. Provide scale or both width and height.","example":"1:1"},"outputNum":{"type":"integer","description":"Number of images to generate, from 1 to 4. Defaults to 4.","example":4}},"required":["imageUrl"],"example":{"imageUrl":"https://example.com/product.jpg","prompt":"same product, brighter background","weight":2,"width":1024,"height":1024,"outputNum":4},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg","prompt":"same product, brighter background","weight":2,"width":1024,"height":1024,"outputNum":4}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"similar-image-variations","x-nexscope-mcp-tool-name":"nexscope_similar_image_variations","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/background-remover/run":{"post":{"tags":["Multimodal AI"],"summary":"Background Remover API","description":"Cut out products, people, or clothing from a source image using an upstream background-removal model.","operationId":"runBackgroundRemover","externalDocs":{"description":"Background Remover API documentation","url":"https://www.nexscope.ai/api-docs/background-remover"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Cut out products, people, or clothing from a source image using an upstream background-removal model.","properties":{"imageUrl":{"type":"string","description":"Public URL of the image to cut out. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height.","example":"https://example.com/product.jpg"},"subType":{"type":"integer","description":"Cutout type. Supported values: 1 (general), 2 (portrait), 3 (product), 9 (apparel), 12 (hair), 13 (face).","example":1},"clothClass":{"type":"string","description":"Apparel classes used only when subType is 9. Multiple values may be comma-separated. Supported values: tops, coat, skirt, pants, bag, shoes, hat.","example":"tops"}},"required":["imageUrl","subType"],"example":{"imageUrl":"https://example.com/product.jpg","subType":1},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg","subType":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"background-remover","x-nexscope-mcp-tool-name":"nexscope_background_remover","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/etsy-store-query/run":{"post":{"tags":["Etsy Marketplace"],"summary":"Etsy Store Query","description":"Returns Etsy store profiles and marketplace performance metrics.","operationId":"runEtsyStoreQuery","externalDocs":{"description":"Etsy Store Query documentation","url":"https://www.nexscope.ai/api-docs/etsy-store-query"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"All filters are optional. Use searchKey to query a specific store name or URL.","properties":{"searchKey":{"type":"string","description":"Store name, keyword, or Etsy store URL.","example":"Lewshop1"},"category":{"type":"string","description":"Primary store category.","example":"Jewelry"},"country":{"type":"string","description":"Store country or region.","example":"US"},"status":{"type":"integer","description":"Store status: 1 active, 0 inactive.","example":1},"isRaving":{"type":"integer","description":"Raving store flag: 1 yes.","example":1},"isStar":{"type":"integer","description":"Star store flag: 1 yes.","example":1},"beginFavorites":{"type":"integer","description":"Minimum total favorites.","example":0},"endFavorites":{"type":"integer","description":"Maximum total favorites.","example":10000},"beginFavoritesWeekly":{"type":"integer","description":"Minimum weekly favorites.","example":0},"endFavoritesWeekly":{"type":"integer","description":"Maximum weekly favorites.","example":1000},"beginReviews":{"type":"integer","description":"Minimum total reviews.","example":0},"endReviews":{"type":"integer","description":"Maximum total reviews.","example":10000},"beginReviewsWeekly":{"type":"integer","description":"Minimum weekly reviews.","example":0},"endReviewsWeekly":{"type":"integer","description":"Maximum weekly reviews.","example":1000},"beginSales":{"type":"integer","description":"Minimum total sales.","example":0},"endSales":{"type":"integer","description":"Maximum total sales.","example":100000},"beginSalesWeekly":{"type":"integer","description":"Minimum weekly sales.","example":0},"endSalesWeekly":{"type":"integer","description":"Maximum weekly sales.","example":1000},"beginStoreOpenedAt":{"type":"string","description":"Opening date range start in YYYY-MM-DD format.","example":"2020-01-01"},"endStoreOpenedAt":{"type":"string","description":"Opening date range end in YYYY-MM-DD format.","example":"2026-01-01"},"sortBy":{"type":"integer","description":"Sort field: 8 total sales, 9 weekly sales, 10 reviews, 11 favorites.","example":8},"sortDesc":{"type":"integer","description":"Sort direction: 1 descending, 0 ascending.","example":1},"page":{"type":"integer","description":"Page number starting from 1.","example":1},"pageSize":{"type":"integer","description":"Items per page from 1 to 100.","example":20}},"example":{"page":1,"searchKey":"Lewshop1","pageSize":20},"additionalProperties":true},"example":{"page":1,"searchKey":"Lewshop1","pageSize":20}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Records returned on the current page.","example":1},{"type":"null"}]},"storeNum":{"anyOf":[{"type":"integer","description":"Total matching stores.","example":1},{"type":"null"}]},"stores":{"anyOf":[{"type":"array","description":"Etsy stores.","example":[],"items":{"type":"object","properties":{"storeId":{"type":"string","description":"Store identifier.","example":"123456"},"storeName":{"type":"string","description":"Store name.","example":"Lewshop1"},"storeUrl":{"type":"string","description":"Etsy store URL.","example":"https://www.etsy.com/shop/Lewshop1"},"logoUrl":{"type":"string","description":"Store avatar URL.","example":null},"shopWebsite":{"type":"string","description":"Store website or external link.","example":null},"startAt":{"type":"string","description":"Store opening date.","example":null},"country":{"type":"array","description":"Store countries or regions.","example":[]},"category":{"type":"array","description":"Primary categories.","example":[]},"productCount":{"type":"integer","description":"Store product count.","example":null},"salesTotal":{"type":"integer","description":"Total sales.","example":1},"salesWeekly":{"type":"integer","description":"Weekly sales.","example":1},"reviews":{"type":"integer","description":"Review count.","example":1},"reviewsWeekly":{"type":"integer","description":"Weekly new review count.","example":null},"favorites":{"type":"integer","description":"Favorite count.","example":1},"favoritesWeekly":{"type":"integer","description":"Weekly new favorite count.","example":null},"rating":{"type":"number","description":"Store rating.","example":4.8},"isRaving":{"type":"integer","description":"Raving store indicator: 1 means yes.","example":null},"isStar":{"type":"integer","description":"Star store indicator: 1 means yes.","example":null},"status":{"type":"integer","description":"Store status.","example":1}}}},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Tool type: ehunt.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type: etsy.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Response title.","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Render style.","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Provider rendering columns.","example":[]},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Provider-reported token cost.","example":3600},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"storeNum":1,"stores":[{"storeId":"123456","storeName":"Lewshop1","storeUrl":"https://www.etsy.com/shop/Lewshop1","country":[],"category":[],"salesTotal":1,"salesWeekly":1,"reviews":1,"favorites":1,"rating":4.8,"status":1}],"columns":[],"costToken":3600},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"etsy-store-query","x-nexscope-mcp-tool-name":"nexscope_etsy_store_query","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/fine-cutout-image-segmentation/run":{"post":{"tags":["Multimodal AI"],"summary":"Fine Cutout Image Segmentation API","description":"Run the Nexscope interactive cutout create/info flow as one Skill API call. The point list marks foreground/background guidance points.","operationId":"runFineCutoutImageSegmentation","externalDocs":{"description":"Fine Cutout Image Segmentation API documentation","url":"https://www.nexscope.ai/api-docs/fine-cutout-image-segmentation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Run the Nexscope interactive cutout create/info flow as one Skill API call. The point list marks foreground/background guidance points.","properties":{"imageUrl":{"type":"string","description":"Public URL of the image to cut out.","example":"https://example.com/product.jpg"},"pointList":{"type":"array","items":{"type":"object","properties":{"x":{"type":"integer"},"y":{"type":"integer"},"isSelect":{"type":"boolean"}},"additionalProperties":true},"description":"Selection points. Each item should include x, y, and isSelect.","example":[{"x":120,"y":180,"isSelect":true}]},"scoreUrl":{"type":"string","description":"Optional score map URL returned by a previous step.","example":"https://example.com/score.png"},"featureUrl":{"type":"string","description":"Optional feature map URL returned by a previous step.","example":"https://example.com/feature.bin"}},"required":["imageUrl","pointList"],"example":{"imageUrl":"https://example.com/product.jpg","pointList":[{"x":120,"y":180,"isSelect":true}],"scoreUrl":"https://example.com/score.png","featureUrl":"https://example.com/feature.bin"},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg","pointList":[{"x":120,"y":180,"isSelect":true}],"scoreUrl":"https://example.com/score.png","featureUrl":"https://example.com/feature.bin"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"fine-cutout-image-segmentation","x-nexscope-mcp-tool-name":"nexscope_fine_cutout_image_segmentation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/image-upscale/run":{"post":{"tags":["Multimodal AI"],"summary":"Image Upscale API","description":"Increase image resolution and optionally enhance visual quality.","operationId":"runImageUpscale","externalDocs":{"description":"Image Upscale API documentation","url":"https://www.nexscope.ai/api-docs/image-upscale"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Increase image resolution and optionally enhance visual quality.","properties":{"imageUrl":{"type":"string","description":"Public URL of the image to upscale. Width and height must each be at most 4096 pixels.","example":"https://example.com/product.jpg"},"magnification":{"type":"number","description":"Upscaling magnification factor from 1 to 4. Decimal values are supported.","example":2},"enhanceQuality":{"type":"boolean","description":"Whether to enhance image quality during upscaling.","example":true}},"required":["imageUrl","magnification"],"example":{"imageUrl":"https://example.com/product.jpg","magnification":2,"enhanceQuality":true},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg","magnification":2,"enhanceQuality":true}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"image-upscale","x-nexscope-mcp-tool-name":"nexscope_image_upscale","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/smart-image-outpainting/run":{"post":{"tags":["Multimodal AI"],"summary":"Smart Image Outpainting API","description":"Generate an expanded image around the original content using target width, height, and optional prompt.","operationId":"runSmartImageOutpainting","externalDocs":{"description":"Smart Image Outpainting API documentation","url":"https://www.nexscope.ai/api-docs/smart-image-outpainting"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate an expanded image around the original content using target width, height, and optional prompt.","properties":{"imageUrl":{"type":"string","description":"Public URL of the image to expand. The image must be between 300 and 4096 pixels in both width and height, and its width-to-height ratio must be between 0.4 and 2.5.","example":"https://example.com/product.jpg"},"width":{"type":"integer","description":"Target output width in pixels.","example":1200},"height":{"type":"integer","description":"Target output height in pixels.","example":900},"prompt":{"type":"string","description":"Optional prompt describing the extended scene.","example":"extend the clean studio background"},"outputNum":{"type":"integer","description":"Number of images to generate, from 1 to 4. Defaults to 1.","example":1}},"required":["imageUrl","width","height"],"example":{"imageUrl":"https://example.com/product.jpg","width":1200,"height":900,"prompt":"extend the clean studio background","outputNum":1},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg","width":1200,"height":900,"prompt":"extend the clean studio background","outputNum":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"smart-image-outpainting","x-nexscope-mcp-tool-name":"nexscope_smart_image_outpainting","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/image-translation/run":{"post":{"tags":["Multimodal AI"],"summary":"Image Translation API","description":"Translate image text from a source language to a target language for ecommerce localization.","operationId":"runImageTranslation","externalDocs":{"description":"Image Translation API documentation","url":"https://www.nexscope.ai/api-docs/image-translation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Translate image text from a source language to a target language for ecommerce localization.","properties":{"imageUrl":{"type":"string","description":"Public URL of a JPG, JPEG, PNG, or WEBP image up to 4 MB and between 385 and 3000 pixels.","example":"https://example.com/product.jpg"},"translationPlatform":{"type":"string","description":"Translation platform. Supported values: deepl (DeepL), chatgpt (ChatGPT).","example":"deepl"},"sourceLanguage":{"type":"string","description":"Source language code. Supported values: CHS (Simplified Chinese), ENG (English), CHT (Traditional Chinese), ESP (Spanish), JPN (Japanese), KOR (Korean), PT (Portuguese), ROM (Romanian), RUS (Russian), VIN (Vietnamese), DEU (German).","example":"CHS"},"targetLanguage":{"type":"string","description":"Target language code. Supported values: AR, BG, BN, CHS, CHT, CKB, CSY, DA, DEU, EL, ENG, ESP, ET, FA, FI, FIL, FRA, GU, HE, HI, HR, HUN, ID, ITA, JPN, JW, KOR, LO, LT, LV, MR, MS, MY, NLD, NO, PLK, PT, PTB, ROM, RUS, SK, SL, SV, SW, TA, TE, TG, TH, TL, TRK, UK, UR, VIN.","example":"ENG"}},"required":["imageUrl","translationPlatform","sourceLanguage","targetLanguage"],"example":{"imageUrl":"https://example.com/product.jpg","translationPlatform":"deepl","sourceLanguage":"CHS","targetLanguage":"ENG"},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg","translationPlatform":"deepl","sourceLanguage":"CHS","targetLanguage":"ENG"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"image-translation","x-nexscope-mcp-tool-name":"nexscope_image_translation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ai-hand-repair/run":{"post":{"tags":["Multimodal AI"],"summary":"AI Hand Repair API","description":"Improve hand appearance in generated model or lifestyle images.","operationId":"runAiHandRepair","externalDocs":{"description":"AI Hand Repair API documentation","url":"https://www.nexscope.ai/api-docs/ai-hand-repair"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Improve hand appearance in generated model or lifestyle images.","properties":{"imageUrl":{"type":"string","description":"Public URL of the image requiring hand repair. The image must be between 300 and 4096 pixels in both width and height, and its width-to-height ratio must be between 0.4 and 2.5.","example":"https://example.com/model-reference.jpg"},"personType":{"type":"integer","description":"Person type. Supported values: 0 (girl), 1 (boy), 2 (adult woman), 3 (adult man).","example":2},"maskUrl":{"type":"string","description":"Optional mask URL for the hand repair area.","example":"https://example.com/mask.png"},"outputNum":{"type":"integer","description":"Number of images to generate, from 1 to 4. Defaults to 1.","example":1}},"required":["imageUrl","personType"],"example":{"imageUrl":"https://example.com/model-reference.jpg","personType":2,"maskUrl":"https://example.com/mask.png","outputNum":1},"additionalProperties":true},"example":{"imageUrl":"https://example.com/model-reference.jpg","personType":2,"maskUrl":"https://example.com/mask.png","outputNum":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ai-hand-repair","x-nexscope-mcp-tool-name":"nexscope_ai_hand_repair","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/image-inpainting/run":{"post":{"tags":["Multimodal AI"],"summary":"Image Inpainting API","description":"Repair or regenerate a local image region using a mask and prompt.","operationId":"runImageInpainting","externalDocs":{"description":"Image Inpainting API documentation","url":"https://www.nexscope.ai/api-docs/image-inpainting"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Repair or regenerate a local image region using a mask and prompt.","properties":{"imageUrl":{"type":"string","description":"Public URL of the base image. The image must be between 300 and 4096 pixels in both width and height, and its width-to-height ratio must be between 0.4 and 2.5.","example":"https://example.com/product.jpg"},"prompt":{"type":"string","description":"Prompt describing how to redraw the masked area.","example":"remove scratches and keep the product realistic"},"maskUrl":{"type":"string","description":"Public URL of the mask image.","example":"https://example.com/mask.png"},"outputNum":{"type":"integer","description":"Number of images to generate, from 1 to 4. Defaults to 1.","example":1}},"required":["imageUrl","prompt","maskUrl"],"example":{"imageUrl":"https://example.com/product.jpg","prompt":"remove scratches and keep the product realistic","maskUrl":"https://example.com/mask.png","outputNum":1},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg","prompt":"remove scratches and keep the product realistic","maskUrl":"https://example.com/mask.png","outputNum":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"image-inpainting","x-nexscope-mcp-tool-name":"nexscope_image_inpainting","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/print-pattern-extraction/run":{"post":{"tags":["Multimodal AI"],"summary":"Print & Pattern Extraction API","description":"Extract visible print or pattern elements from product imagery.","operationId":"runPrintPatternExtraction","externalDocs":{"description":"Print & Pattern Extraction API documentation","url":"https://www.nexscope.ai/api-docs/print-pattern-extraction"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Extract visible print or pattern elements from product imagery.","properties":{"imageUrl":{"type":"string","description":"Public URL of the image containing the print. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height.","example":"https://example.com/product.jpg"}},"required":["imageUrl"],"example":{"imageUrl":"https://example.com/product.jpg"},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"print-pattern-extraction","x-nexscope-mcp-tool-name":"nexscope_print_pattern_extraction","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/maidalv-product-tro-detection/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Product TRO Detection","description":"Analyzes a main product image with optional evidence images, text, keywords, and language.","operationId":"runMaidalvProductTroDetection","externalDocs":{"description":"Product TRO Detection documentation","url":"https://www.nexscope.ai/api-docs/maidalv-product-tro-detection"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"mainProductImage is required. API callers must provide HTTPS URLs; local file paths are not accepted by Run.","properties":{"mainProductImage":{"type":"string","description":"Public HTTPS URL of the main product image.","example":"https://example.com/product.jpg"},"referenceImages":{"type":"array","items":{},"description":"Public reference image URLs.","example":[]},"otherProductImages":{"type":"array","items":{},"description":"Additional product image URLs.","example":[]},"ipImages":{"type":"array","items":{},"description":"Known intellectual-property evidence image URLs.","example":[]},"referenceText":{"type":"string","description":"Reference text associated with the product.","example":"Wireless speaker"},"description":{"type":"string","description":"Product description used as additional evidence.","example":"Portable wireless speaker"},"ipKeywords":{"type":"array","items":{},"description":"Intellectual-property keywords.","example":["speaker"]},"language":{"type":"string","description":"Requested response language.","example":"en"}},"required":["mainProductImage"],"example":{"language":"en","mainProductImage":"https://example.com/product.jpg"},"additionalProperties":true},"example":{"language":"en","mainProductImage":"https://example.com/product.jpg"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"checkId":{"anyOf":[{"type":"string","description":"Provider check identifier.","example":"check-id"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","description":"Detection status.","example":"success"},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"Number of high-risk findings in results[].","example":2},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider render style.","example":null},{"type":"null"}]},"results":{"anyOf":[{"type":"array","description":"High-risk potential infringement findings.","example":[],"items":{"type":"object","properties":{"riskLevel":{"anyOf":[{"type":"string","description":"Risk grade when scored.","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Provider render columns, which may differ in length from finding lists.","example":null},{"type":"null"}]},"ipType":{"type":"string","description":"IP type: Trademark, Copyright, or Patent.","example":null},"text":{"type":"string","description":"IP text, such as a trademark or patent title.","example":null},"ipOwner":{"type":"string","description":"IP owner.","example":null},"regNo":{"type":"string","description":"Registration number, possibly a JSON-encoded array.","example":null},"riskScore":{"type":"number","description":"Risk score from 0 to 10 when scored.","example":null},"riskDescription":{"type":"string","description":"Risk explanation when scored.","example":null},"ipAssetUrls":{"type":"array","description":"IP evidence image URLs.","example":null},"plaintiffId":{"type":"integer","description":"TRO plaintiff ID when available.","example":null},"plaintiffName":{"type":"string","description":"TRO plaintiff name when available.","example":null},"numberOfCases":{"type":"integer","description":"Plaintiff case count when available.","example":null},"lastCaseDocket":{"type":"string","description":"Latest case docket when available.","example":null},"lastCaseDateFiled":{"type":"string","description":"Latest case filing date when available.","example":null},"report":{"type":"string","description":"AI legal assessment report in the requested language.","example":null}}}},{"type":"null"}]},"nonResults":{"anyOf":[{"type":"array","description":"Other IP findings, including possible TRO plaintiff details.","example":[],"items":{"type":"object","properties":{"ipType":{"type":"string","description":"IP type: Trademark, Copyright, or Patent.","example":null},"text":{"type":"string","description":"IP text, such as a trademark or patent title.","example":null},"ipOwner":{"type":"string","description":"IP owner.","example":null},"regNo":{"type":"string","description":"Registration number, possibly a JSON-encoded array.","example":null},"riskLevel":{"type":"string","description":"Risk grade when scored.","example":null},"riskScore":{"type":"number","description":"Risk score from 0 to 10 when scored.","example":null},"riskDescription":{"type":"string","description":"Risk explanation when scored.","example":null},"ipAssetUrls":{"type":"array","description":"IP evidence image URLs.","example":null},"plaintiffId":{"type":"integer","description":"TRO plaintiff ID when available.","example":null},"plaintiffName":{"type":"string","description":"TRO plaintiff name when available.","example":null},"numberOfCases":{"type":"integer","description":"Plaintiff case count when available.","example":null},"lastCaseDocket":{"type":"string","description":"Latest case docket when available.","example":null},"lastCaseDateFiled":{"type":"string","description":"Latest case filing date when available.","example":null},"report":{"type":"string","description":"AI legal assessment report in the requested language.","example":null}}}},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Provider-reported token cost.","example":225000},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"checkId":"check-id","status":"success","total":2,"results":[],"nonResults":[],"costToken":225000},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"maidalv-product-tro-detection","x-nexscope-mcp-tool-name":"nexscope_maidalv_product_tro_detection","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/mercado-product-selection/run":{"post":{"tags":["Product & Market Research"],"summary":"Mercado Product Selection","description":"Validates the selected tool and its required arguments before calling the governed Lingdong gateway.","operationId":"runMercadoProductSelection","externalDocs":{"description":"Mercado Product Selection documentation","url":"https://www.nexscope.ai/api-docs/mercado-product-selection"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"toolName must be one of the 24 documented values. Required argument fields depend on toolName.","properties":{"toolName":{"type":"string","description":"Exact Mercado tool name.","example":"categorySearch"},"arguments":{"type":"object","additionalProperties":true,"description":"Arguments for the selected tool.","example":{"searchText":"Auriculares","siteId":"MLM"}}},"required":["toolName","arguments"],"example":{"arguments":{"searchText":"Auriculares","siteId":"MLM"},"toolName":"categorySearch"},"additionalProperties":true},"example":{"arguments":{"searchText":"Auriculares","siteId":"MLM"},"toolName":"categorySearch"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"type":{"anyOf":[{"type":"string","description":"Provider result type.","example":"rawMcpToolResult"},{"type":"null"}]},"toolName":{"anyOf":[{"type":"string","description":"Executed Mercado tool name.","example":"categorySearch"},{"type":"null"}]},"charged":{"anyOf":[{"type":"boolean","description":"Whether the selected tool is paid.","example":false},{"type":"null"}]},"data":{"anyOf":[{"type":["object","array","string","null"],"description":"Parsed business data, or provider text when the result is not JSON.","example":{}},{"type":"null"}]},"contentText":{"anyOf":[{"type":"string","description":"Original concatenated provider text.","example":"Category results..."},{"type":"null"}]},"textParsedAsJson":{"anyOf":[{"type":"boolean","description":"Whether provider text was parsed as JSON.","example":true},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"Inferred result count when available.","example":1},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Provider-reported token cost; free tools return zero.","example":0},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Gateway execution time in milliseconds.","example":308},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"type":"rawMcpToolResult","toolName":"categorySearch","charged":false,"data":{},"contentText":"Category results...","textParsedAsJson":true,"total":1,"costToken":0,"costTime":308},"code":0,"msg":"ok","ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"mercado-product-selection","x-nexscope-mcp-tool-name":"nexscope_mercado_product_selection","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/object-eraser-image-object-removal/run":{"post":{"tags":["Multimodal AI"],"summary":"Object Eraser & Image Object Removal API","description":"Remove selected objects or regions using a mask image.","operationId":"runObjectEraserImageObjectRemoval","externalDocs":{"description":"Object Eraser & Image Object Removal API documentation","url":"https://www.nexscope.ai/api-docs/object-eraser-image-object-removal"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Remove selected objects or regions using a mask image.","properties":{"imageUrl":{"type":"string","description":"Public URL of the base image. The image must be between 300 and 4096 pixels in both width and height, and its width-to-height ratio must be between 0.4 and 2.5.","example":"https://example.com/product.jpg"},"maskImageUrl":{"type":"string","description":"Public URL of the mask image for the area to erase.","example":"https://example.com/mask.png"}},"required":["imageUrl","maskImageUrl"],"example":{"imageUrl":"https://example.com/product.jpg","maskImageUrl":"https://example.com/mask.png"},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg","maskImageUrl":"https://example.com/mask.png"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"object-eraser-image-object-removal","x-nexscope-mcp-tool-name":"nexscope_object_eraser_image_object_removal","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/jewelry-text-design/run":{"post":{"tags":["Multimodal AI"],"summary":"Jewelry Text Design API","description":"Create decorative linked-word imagery using font, size, and prompt controls.","operationId":"runJewelryTextDesign","externalDocs":{"description":"Jewelry Text Design API documentation","url":"https://www.nexscope.ai/api-docs/jewelry-text-design"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Create decorative linked-word imagery using font, size, and prompt controls.","properties":{"fontname":{"type":"string","description":"Font name. Allowed values: Caitlyn, ItaliannoRob, Alison, ALSScript, WhiteAngelica, Milkshake, ScriptMTBold, PassionsConflictROB, Sacramento, Cervanttis, Notera 2 PERSONAL USE ONLY, UyghurMerdane, OldEnglishText, Halimun, AlexBrush, Scriptina, CounselorScript, EliannaBoldItalic, AutumnChant, MagnoliaScript.","example":"UyghurMerdane"},"fontSize":{"type":"integer","description":"Output font size.","example":10},"left":{"type":"boolean","description":"Whether to add a ring on the left side. Defaults to false.","example":false},"right":{"type":"boolean","description":"Whether to add a ring on the right side. Defaults to false.","example":false},"prompt":{"type":"string","description":"Jewelry text content.","example":"hello"}},"required":["fontname","fontSize","prompt"],"example":{"fontname":"UyghurMerdane","fontSize":10,"left":false,"right":false,"prompt":"hello"},"additionalProperties":true},"example":{"fontname":"UyghurMerdane","fontSize":10,"left":false,"right":false,"prompt":"hello"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"jewelry-text-design","x-nexscope-mcp-tool-name":"nexscope_jewelry_text_design","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/handheld-product-mockup/run":{"post":{"tags":["Multimodal AI"],"summary":"Handheld Product Mockup API","description":"Generate natural hand-held product imagery from a person image and target product asset.","operationId":"runHandheldProductMockup","externalDocs":{"description":"Handheld Product Mockup API documentation","url":"https://www.nexscope.ai/api-docs/handheld-product-mockup"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate natural hand-held product imagery from a person image and target product asset.","properties":{"imageUrl":{"type":"string","description":"Public URL of the product image. The image must be at most 20 MB and between 385 and 8192 pixels in both width and height.","example":"https://example.com/product.jpg"},"targetOriginUrl":{"type":"string","description":"Public URL of the person or hand pose image.","example":"https://example.com/model-reference.jpg"},"targetMaskUrl":{"type":"string","description":"Public URL of the black-and-white hand-held area mask. Required because this API accepts custom pose images rather than saved upstream materials.","example":"https://example.com/mask.png"},"outputNum":{"type":"integer","description":"Number of images to generate, from 1 to 4. Defaults to 1.","example":1}},"required":["imageUrl","targetOriginUrl","targetMaskUrl"],"example":{"imageUrl":"https://example.com/product.jpg","targetOriginUrl":"https://example.com/model-reference.jpg","targetMaskUrl":"https://example.com/mask.png","outputNum":1},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg","targetOriginUrl":"https://example.com/model-reference.jpg","targetMaskUrl":"https://example.com/mask.png","outputNum":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"handheld-product-mockup","x-nexscope-mcp-tool-name":"nexscope_handheld_product_mockup","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/image-captioning/run":{"post":{"tags":["Multimodal AI"],"summary":"Image Captioning API","description":"Extract descriptive prompts or selling-point text from one or more images.","operationId":"runImageCaptioning","externalDocs":{"description":"Image Captioning API documentation","url":"https://www.nexscope.ai/api-docs/image-captioning"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Extract descriptive prompts or selling-point text from one or more images.","properties":{"type":{"type":"integer","description":"Analysis type. Supported values: 5 (similar-image prompt), 13 (scene prompt), 30 (image-to-video analysis), 69 (apparel selling points), 71 (product selling points), 73 (sales-video script), 89 (video-reclone prompt).","example":71},"imageUrlList":{"type":"array","items":{"type":"string"},"description":"Public image URLs used for analysis. Provide no more than 6 images for modes that accept multiple images.","example":["https://example.com/product.jpg"],"minItems":1,"maxItems":6},"keyword":{"type":"string","description":"Optional keyword context.","example":"phone case"},"provider":{"type":"string","description":"Analysis provider. Supported values: API_PRE_POINT (default), API_LAYOUT_DESC.","example":"API_PRE_POINT"},"refVideoUrl":{"type":"string","description":"Reference video URL. Required when type is 89.","example":"https://example.com/reference-video.mp4"},"saleCountry":{"type":"string","description":"Target sale country code.","example":"US"},"targetLanguage":{"type":"string","description":"Target language for generated text. Used by video-reclone analysis.","example":"English"},"duration":{"type":"integer","description":"Target duration in seconds. Used by video-reclone analysis.","example":15}},"required":["type","imageUrlList"],"example":{"type":71,"imageUrlList":["https://example.com/product.jpg"],"keyword":"phone case","provider":"API_PRE_POINT"},"additionalProperties":true},"example":{"type":71,"imageUrlList":["https://example.com/product.jpg"],"keyword":"phone case","provider":"API_PRE_POINT"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"image-captioning","x-nexscope-mcp-tool-name":"nexscope_image_captioning","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/product-image-enhancement/run":{"post":{"tags":["Multimodal AI"],"summary":"Product Image Enhancement API","description":"Improve product presentation quality in a single ecommerce image.","operationId":"runProductImageEnhancement","externalDocs":{"description":"Product Image Enhancement API documentation","url":"https://www.nexscope.ai/api-docs/product-image-enhancement"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Improve product presentation quality in a single ecommerce image.","properties":{"imageUrl":{"type":"string","description":"Public URL of the product image to retouch. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height.","example":"https://example.com/product.jpg"}},"required":["imageUrl"],"example":{"imageUrl":"https://example.com/product.jpg"},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"product-image-enhancement","x-nexscope-mcp-tool-name":"nexscope_product_image_enhancement","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/image-text-editing/run":{"post":{"tags":["Multimodal AI"],"summary":"Image Text Editing API","description":"Use an image mask to remove or edit text regions in an ecommerce image.","operationId":"runImageTextEditing","externalDocs":{"description":"Image Text Editing API documentation","url":"https://www.nexscope.ai/api-docs/image-text-editing"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Use an image mask to remove or edit text regions in an ecommerce image.","properties":{"imageUrl":{"type":"string","description":"Public URL of the base image.","example":"https://example.com/product.jpg"},"imageMaskUrl":{"type":"string","description":"Public URL of the text mask image.","example":"https://example.com/mask.png"}},"required":["imageUrl","imageMaskUrl"],"example":{"imageUrl":"https://example.com/product.jpg","imageMaskUrl":"https://example.com/mask.png"},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg","imageMaskUrl":"https://example.com/mask.png"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"image-text-editing","x-nexscope-mcp-tool-name":"nexscope_image_text_editing","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/smart-image-edit-manipulation-v3/run":{"post":{"tags":["Multimodal AI"],"summary":"Smart Image Edit & Manipulation API v3","description":"Perform general image editing with provider, prompt, resolution, aspect ratio, and quality controls.","operationId":"runSmartImageEditManipulationV3","externalDocs":{"description":"Smart Image Edit & Manipulation API v3 documentation","url":"https://www.nexscope.ai/api-docs/smart-image-edit-manipulation-v3"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Perform general image editing with provider, prompt, resolution, aspect ratio, and quality controls.","properties":{"imageUrl":{"type":"string","description":"Public URL of the image to edit. The image must be between 300 and 4096 pixels in both width and height, and its width-to-height ratio must be between 0.4 and 2.5.","example":"https://example.com/product.jpg"},"prompt":{"type":"string","description":"Editing instruction.","example":"make the background pure white and keep the product unchanged"},"provider":{"type":"string","description":"Image model. Supported values: BANANA, BANANA_2, BANANA_PRO, WAN2_7, QWEN_IMAGE_3_PRO, SEEDREAM5, GPT_2_IMAGE, or AIDRAW_EDIT.","example":"BANANA_PRO"},"outputNum":{"type":"integer","description":"Number of images to generate, from 1 to 4.","example":1},"resolution":{"type":"string","description":"Target resolution preset.","example":"1K"},"aspectRatio":{"type":"string","description":"Target aspect ratio.","example":"1:1"},"supplyType":{"type":"string","description":"Generation route. Supported values: eco or stable. Defaults to stable.","example":"stable"},"needOptimize":{"type":"boolean","description":"Whether the prompt should be optimized upstream.","example":true},"template":{"type":"string","description":"Optional Nexscope editing template. Supported values: white-background, product-main-image-retouching, scene-generation, poster-design, add-person-or-object, change-animal, flat-lay-apparel, 3d-apparel, mannequin-to-model, cartoon-illustration, body-reshape, change-style, remove-element, remove-text, remove-watermark, add-watermark.","example":"white-background"},"source":{"type":"string","description":"Optional traffic or product source code.","example":"api"},"quality":{"type":"string","description":"GPT Image quality only. Supported values: low, medium, or high. Defaults to medium.","example":"medium"}},"required":["imageUrl","prompt","provider"],"example":{"imageUrl":"https://example.com/product.jpg","prompt":"make the background pure white and keep the product unchanged","provider":"BANANA_PRO","outputNum":1,"resolution":"1K","aspectRatio":"1:1","supplyType":"stable","needOptimize":true,"template":"white-background","source":"api","quality":"medium"},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg","prompt":"make the background pure white and keep the product unchanged","provider":"BANANA_PRO","outputNum":1,"resolution":"1K","aspectRatio":"1:1","supplyType":"stable","needOptimize":true,"template":"white-background","source":"api","quality":"medium"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"smart-image-edit-manipulation-v3","x-nexscope-mcp-tool-name":"nexscope_smart_image_edit_manipulation_v3","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/whitebg-image/run":{"post":{"tags":["Multimodal AI"],"summary":"White Background Product Image API","description":"Generate one square white-background product image from one or two references of the same product using GPT Image 2. Submit one approved target per request. Review product identity and listing suitability before use; this endpoint does not perform reference inspection, image-set planning, or marketplace compliance certification. Generation consumes Nexscope credits.","operationId":"runWhitebgImage","externalDocs":{"description":"White Background Product Image API documentation","url":"https://www.nexscope.ai/api-docs/whitebg-image"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate one square white-background product image from one or two references of the same product using GPT Image 2. Submit one approved target per request. Review product identity and listing suitability before use; this endpoint does not perform reference inspection, image-set planning, or marketplace compliance certification. Generation consumes Nexscope credits.","properties":{"imageList":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs of the same product. Provide up to 2 JPG, JPEG, PNG, or WEBP images; each image must be at most 10 MB and between 800 and 4096 pixels.","example":["https://example.com/product.jpg"],"minItems":1,"maxItems":2},"prompt":{"type":"string","description":"Describe one target supported by the references, up to 350 characters. Output is fixed to one 1:1 image.","example":"Show the complete product from the supplied front view.","maxLength":350}},"required":["imageList","prompt"],"example":{"imageList":["https://example.com/product.jpg"],"prompt":"Show the complete product from the supplied front view."},"additionalProperties":true},"example":{"imageList":["https://example.com/product.jpg"],"prompt":"Show the complete product from the supplied front view."}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"whitebg-image","x-nexscope-mcp-tool-name":"nexscope_whitebg_image","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/smart-multi-image-editing-v3/run":{"post":{"tags":["Multimodal AI"],"summary":"Smart Multi-Image Editing API v3","description":"Create an edited output from multiple source images using prompt, provider, resolution, and quality controls.","operationId":"runSmartMultiImageEditingV3","externalDocs":{"description":"Smart Multi-Image Editing API v3 documentation","url":"https://www.nexscope.ai/api-docs/smart-multi-image-editing-v3"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Create an edited output from multiple source images using prompt, provider, resolution, and quality controls.","properties":{"imageList":{"type":"array","items":{"type":"string"},"description":"Public image URLs to combine or reference. Provide no more than 6 JPG, JPEG, PNG, or WEBP images; each image must be at most 10 MB and between 800 and 4096 pixels.","example":["https://example.com/product.jpg","https://example.com/model-reference.jpg"],"minItems":1,"maxItems":6},"provider":{"type":"string","description":"Image model. Supported values: BANANA, BANANA_2, BANANA_PRO, WAN2_7, QWEN_IMAGE_3_PRO, SEEDREAM5, GPT_2_IMAGE, or AIDRAW_EDIT.","example":"BANANA_PRO"},"prompt":{"type":"string","description":"Optional fusion instruction, up to 600 characters.","example":"combine the product with the model in a clean studio scene"},"outputNum":{"type":"integer","description":"Number of images to generate. Defaults to 1.","example":1},"resolution":{"type":"string","description":"Target resolution preset.","example":"1K"},"aspectRatio":{"type":"string","description":"Target aspect ratio.","example":"1:1"},"supplyType":{"type":"string","description":"Generation route. Supported values: eco or stable. Defaults to stable.","example":"stable"},"needOptimize":{"type":"boolean","description":"Whether the prompt should be optimized upstream.","example":true},"template":{"type":"string","description":"Optional fusion template. Supported values: outfit-fusion, outfit-try-on.","example":"outfit-fusion"},"quality":{"type":"string","description":"GPT Image quality only. Supported values: low, medium, or high. Defaults to medium.","example":"medium"}},"required":["imageList","provider"],"example":{"imageList":["https://example.com/product.jpg","https://example.com/model-reference.jpg"],"provider":"BANANA_PRO","prompt":"combine the product with the model in a clean studio scene","outputNum":1,"resolution":"1K","aspectRatio":"1:1","supplyType":"stable","needOptimize":true,"template":"outfit-fusion","quality":"medium"},"additionalProperties":true},"example":{"imageList":["https://example.com/product.jpg","https://example.com/model-reference.jpg"],"provider":"BANANA_PRO","prompt":"combine the product with the model in a clean studio scene","outputNum":1,"resolution":"1K","aspectRatio":"1:1","supplyType":"stable","needOptimize":true,"template":"outfit-fusion","quality":"medium"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"smart-multi-image-editing-v3","x-nexscope-mcp-tool-name":"nexscope_smart_multi_image_editing_v3","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ai-video-reclone/run":{"post":{"tags":["Multimodal AI"],"summary":"AI Video Reclone API","description":"Generate a product marketing video using a reference video, reference images, and model-specific generation settings.","operationId":"runAiVideoReclone","externalDocs":{"description":"AI Video Reclone API documentation","url":"https://www.nexscope.ai/api-docs/ai-video-reclone"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate a product marketing video using a reference video, reference images, and model-specific generation settings.","properties":{"refVideoUrl":{"type":"string","description":"Public URL of the reference video.","example":"https://example.com/reference-video.mp4"},"refImageList":{"type":"array","items":{"type":"string"},"description":"Public image URLs for product or visual references.","example":["https://example.com/product.jpg"]},"videoType":{"type":"string","description":"Video model. Supported values: seedance-2-0, seedance-2-0-fast, seedance-2-0-mini, seedance-2-5, or happyhorse-v2.","example":"seedance-2-0-fast"},"videoTime":{"type":"integer","description":"Optional target video duration in seconds. Seedance 2.0, Fast, Mini, and HappyHorse V2 support any integer from 5 through 15; Seedance 2.5 supports 5, 10, 15, 20, 25, or 30.","example":10},"resolution":{"type":"string","description":"Target video resolution supported by the selected model, such as 720p or 1080p.","example":"720p"},"aspectRatio":{"type":"string","description":"Target video aspect ratio supported by the selected model.","example":"9:16"},"saleCountry":{"type":"string","description":"Target market country code used to localize the recreated video.","example":"US"},"targetLanguage":{"type":"string","description":"Target spoken and on-screen language for the recreated video.","example":"English"},"productInfo":{"type":"string","description":"Concise product information used to guide the recreation. Maximum 2500 characters.","example":"Slim shockproof phone case with a clear finish."},"prompt":{"type":"string","description":"Optional creative direction prompt.","example":"highlight the slim protective design"}},"required":["refVideoUrl","refImageList","videoType","resolution","saleCountry","targetLanguage"],"example":{"refVideoUrl":"https://example.com/reference-video.mp4","refImageList":["https://example.com/product.jpg"],"videoType":"seedance-2-0-fast","videoTime":10,"resolution":"720p","aspectRatio":"9:16","saleCountry":"US","targetLanguage":"English","productInfo":"Slim shockproof phone case with a clear finish.","prompt":"highlight the slim protective design"},"additionalProperties":true},"example":{"refVideoUrl":"https://example.com/reference-video.mp4","refImageList":["https://example.com/product.jpg"],"videoType":"seedance-2-0-fast","videoTime":10,"resolution":"720p","aspectRatio":"9:16","saleCountry":"US","targetLanguage":"English","productInfo":"Slim shockproof phone case with a clear finish.","prompt":"highlight the slim protective design"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ai-video-reclone","x-nexscope-mcp-tool-name":"nexscope_ai_video_reclone","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ai-product-marketing-image-set-v4/run":{"post":{"tags":["Multimodal AI"],"summary":"AI Product Marketing Image Set API v4","description":"Create ecommerce product marketing materials such as selling-point images and A+ style visuals from product images and brief inputs.","operationId":"runAiProductMarketingImageSetV4","externalDocs":{"description":"AI Product Marketing Image Set API v4 documentation","url":"https://www.nexscope.ai/api-docs/ai-product-marketing-image-set-v4"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Create ecommerce product marketing materials such as selling-point images and A+ style visuals from product images and brief inputs.","properties":{"imageList":{"type":"array","items":{"type":"string"},"description":"Public product image URLs. Provide no more than 5 JPG, JPEG, PNG, or WEBP images; each image must be at most 10 MB and between 800 and 4096 pixels.","example":["https://example.com/product.jpg"],"minItems":1,"maxItems":5},"provider":{"type":"string","description":"Image model. Defaults to BANANA_2. Supported values: BANANA_2, BANANA_2_LITE, BANANA_PRO, WAN2_7, SEEDREAM5_PRO, GPT_2_IMAGE.","example":"BANANA_2"},"sellerPoint":{"type":"string","description":"Product selling points, up to 2500 characters. Required when isExtractPrePoint is false.","example":"Shockproof, slim, clear phone case","maxLength":2500},"isExtractPrePoint":{"type":"boolean","description":"Whether to automatically extract selling points. Defaults to false. When false, sellerPoint is required.","example":false},"resolution":{"type":"string","description":"Target resolution supported by the selected provider.","example":"2K"},"aspectRatio":{"type":"string","description":"Target aspect ratio supported by the selected provider.","example":"1:1"},"noText":{"type":"boolean","description":"Whether generated images should avoid text.","example":false},"brandKey":{"type":"string","description":"Optional brand information serialized as a JSON string. Supported keys: brandColor, fontStyle, salesRegion, language, platform, customSettings.","example":"{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}"},"quality":{"type":"string","description":"GPT Image quality only. Supported values: low, medium, or high.","example":"medium"},"sensitiveLibraryId":{"type":"integer","description":"Optional sensitive-word library ID used to screen generated copy.","example":1001},"replaceLibraryId":{"type":"integer","description":"Optional replacement-word library ID used to rewrite generated copy.","example":1002},"aPlusNum":{"type":"integer","description":"Number of standard A+ images, from 0 to 12. Defaults to 0.","example":0},"aPlusProNum":{"type":"integer","description":"Number of premium A+ images, from 0 to 12. Defaults to 0.","example":0},"aPlusHasPhone":{"type":"boolean","description":"Whether A+ output includes phone display layouts.","example":false},"aPlusAspectRatio":{"type":"string","description":"Premium A+ aspect ratio. Supported values: 16:9, 9:16, 1:1, 1:3.7.","example":"1:1"},"sellerTypeNum":{"type":"integer","description":"Number of selling-point images, from 0 to 12. Defaults to 0.","example":0},"sceneTypeNum":{"type":"integer","description":"Number of scene images, from 0 to 12. Defaults to 0.","example":0},"closeUpTypeNum":{"type":"integer","description":"Number of close-up images, from 0 to 12. Defaults to 0.","example":0},"closeUpWhiteTypeNum":{"type":"integer","description":"Number of white-background close-up images, from 0 to 12. Defaults to 0.","example":0},"whiteBgTypeNum":{"type":"integer","description":"Number of white-background images, from 0 to 12. Defaults to 0.","example":0},"aPlusStyles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"prompt":{"type":"string"}},"additionalProperties":true},"description":"Optional A+ style entries. Each item may contain a saved style id or a custom prompt.","example":[{"id":1},{"prompt":"clean premium layout"}]},"pointStyles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"prompt":{"type":"string"}},"additionalProperties":true},"description":"Optional selling-point style entries. Each item may contain a saved style id or a custom prompt.","example":[{"id":2},{"prompt":"minimal feature callouts"}]}},"required":["imageList"],"example":{"imageList":["https://example.com/product.jpg"],"provider":"BANANA_2","sellerPoint":"Shockproof, slim, clear phone case","isExtractPrePoint":false,"resolution":"2K","aspectRatio":"1:1","noText":false,"brandKey":"{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}","quality":"medium","sensitiveLibraryId":1001,"replaceLibraryId":1002,"aPlusNum":0,"aPlusProNum":0,"aPlusHasPhone":false,"aPlusAspectRatio":"1:1","sellerTypeNum":0,"sceneTypeNum":0,"closeUpTypeNum":0,"closeUpWhiteTypeNum":0,"whiteBgTypeNum":0,"aPlusStyles":[{"id":1},{"prompt":"clean premium layout"}],"pointStyles":[{"id":2},{"prompt":"minimal feature callouts"}]},"additionalProperties":true},"example":{"imageList":["https://example.com/product.jpg"],"provider":"BANANA_2","sellerPoint":"Shockproof, slim, clear phone case","isExtractPrePoint":false,"resolution":"2K","aspectRatio":"1:1","noText":false,"brandKey":"{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}","quality":"medium","sensitiveLibraryId":1001,"replaceLibraryId":1002,"aPlusNum":0,"aPlusProNum":0,"aPlusHasPhone":false,"aPlusAspectRatio":"1:1","sellerTypeNum":0,"sceneTypeNum":0,"closeUpTypeNum":0,"closeUpWhiteTypeNum":0,"whiteBgTypeNum":0,"aPlusStyles":[{"id":1},{"prompt":"clean premium layout"}],"pointStyles":[{"id":2},{"prompt":"minimal feature callouts"}]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ai-product-marketing-image-set-v4","x-nexscope-mcp-tool-name":"nexscope_ai_product_marketing_image_set_v4","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ai-apparel-image-set-photography-v3/run":{"post":{"tags":["Multimodal AI"],"summary":"AI Apparel Image Set & Photography API v3","description":"Create apparel ecommerce image sets from clothing images with optional model and scene references.","operationId":"runAiApparelImageSetPhotographyV3","externalDocs":{"description":"AI Apparel Image Set & Photography API v3 documentation","url":"https://www.nexscope.ai/api-docs/ai-apparel-image-set-photography-v3"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Create apparel ecommerce image sets from clothing images with optional model and scene references.","properties":{"imageList":{"type":"array","items":{"type":"string"},"description":"Public apparel image URLs. Provide no more than 5 JPG, JPEG, PNG, or WEBP images; each image must be at most 10 MB and between 384 and 4096 pixels.","example":["https://example.com/product.jpg"],"minItems":1,"maxItems":5},"provider":{"type":"string","description":"Image model. Defaults to BANANA_2. Supported values: BANANA_2, BANANA_2_LITE, BANANA_PRO, WAN2_7, SEEDREAM5_PRO, GPT_2_IMAGE.","example":"BANANA_2"},"sellerPoint":{"type":"string","description":"Product selling points, up to 2500 characters. Required when isExtractPrePoint is false.","example":"Lightweight breathable summer dress","maxLength":2500},"isExtractPrePoint":{"type":"boolean","description":"Whether to automatically extract selling points. Defaults to false. When false, sellerPoint is required.","example":false},"resolution":{"type":"string","description":"Target resolution supported by the selected provider.","example":"2K"},"aspectRatio":{"type":"string","description":"Target aspect ratio.","example":"1:1"},"noText":{"type":"boolean","description":"Whether generated images should avoid text.","example":false},"brandKey":{"type":"string","description":"Optional brand information serialized as a JSON string. Supported keys: brandColor, fontStyle, salesRegion, language, platform, customSettings.","example":"{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}"},"quality":{"type":"string","description":"GPT Image quality only. Supported values: low, medium, or high.","example":"medium"},"sensitiveLibraryId":{"type":"integer","description":"Optional sensitive-word library ID used to screen generated copy.","example":1001},"replaceLibraryId":{"type":"integer","description":"Optional replacement-word library ID used to rewrite generated copy.","example":1002},"modelImageUrl":{"type":"string","description":"Optional model reference image URL.","example":"https://example.com/model-reference.jpg"},"sceneImageUrl":{"type":"string","description":"Optional scene reference image URL.","example":"https://example.com/scene.jpg"},"isExactScene":{"type":"boolean","description":"Whether to match the provided scene closely. Defaults to true.","example":true},"modelAndSceneInfo":{"type":"string","description":"Model and scene information serialized as a JSON string or concise structured text.","example":"{\"model\":\"female adult\",\"scene\":\"studio\"}"},"aPlusNum":{"type":"integer","description":"Number of standard A+ images, from 0 to 12. Defaults to 0.","example":0},"aPlusProNum":{"type":"integer","description":"Number of premium A+ images, from 0 to 12. Defaults to 0.","example":0},"aPlusHasPhone":{"type":"boolean","description":"Whether A+ output includes phone display layouts.","example":false},"aPlusAspectRatio":{"type":"string","description":"A+ output aspect ratio. Supported values: 16:9, 9:16, 1:1, 1:3.7.","example":"1:1"},"modelTypeNum":{"type":"integer","description":"Number of model images, from 0 to 12. Defaults to 0.","example":0},"insTypeNum":{"type":"integer","description":"Number of social-style images, from 0 to 12. Defaults to 0.","example":0},"sellerTypeNum":{"type":"integer","description":"Number of selling-point images, from 0 to 12. Defaults to 0.","example":0},"sizeTypeNum":{"type":"integer","description":"Number of size-information images, from 0 to 12. Defaults to 0.","example":0},"whiteTypeNum":{"type":"integer","description":"Number of white-background images, from 0 to 12. Defaults to 0.","example":0},"aPlusStyles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"prompt":{"type":"string"}},"additionalProperties":true},"description":"Optional A+ style entries. Each item may contain a saved style id or a custom prompt.","example":[{"id":1},{"prompt":"clean editorial layout"}]},"pointStyles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"prompt":{"type":"string"}},"additionalProperties":true},"description":"Optional selling-point style entries. Each item may contain a saved style id or a custom prompt.","example":[{"id":2},{"prompt":"minimal feature callouts"}]}},"required":["imageList"],"example":{"imageList":["https://example.com/product.jpg"],"provider":"BANANA_2","sellerPoint":"Lightweight breathable summer dress","isExtractPrePoint":false,"resolution":"2K","aspectRatio":"1:1","noText":false,"brandKey":"{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}","quality":"medium","sensitiveLibraryId":1001,"replaceLibraryId":1002,"modelImageUrl":"https://example.com/model-reference.jpg","sceneImageUrl":"https://example.com/scene.jpg","isExactScene":true,"modelAndSceneInfo":"{\"model\":\"female adult\",\"scene\":\"studio\"}","aPlusNum":0,"aPlusProNum":0,"aPlusHasPhone":false,"aPlusAspectRatio":"1:1","modelTypeNum":0,"insTypeNum":0,"sellerTypeNum":0,"sizeTypeNum":0,"whiteTypeNum":0,"aPlusStyles":[{"id":1},{"prompt":"clean editorial layout"}],"pointStyles":[{"id":2},{"prompt":"minimal feature callouts"}]},"additionalProperties":true},"example":{"imageList":["https://example.com/product.jpg"],"provider":"BANANA_2","sellerPoint":"Lightweight breathable summer dress","isExtractPrePoint":false,"resolution":"2K","aspectRatio":"1:1","noText":false,"brandKey":"{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}","quality":"medium","sensitiveLibraryId":1001,"replaceLibraryId":1002,"modelImageUrl":"https://example.com/model-reference.jpg","sceneImageUrl":"https://example.com/scene.jpg","isExactScene":true,"modelAndSceneInfo":"{\"model\":\"female adult\",\"scene\":\"studio\"}","aPlusNum":0,"aPlusProNum":0,"aPlusHasPhone":false,"aPlusAspectRatio":"1:1","modelTypeNum":0,"insTypeNum":0,"sellerTypeNum":0,"sizeTypeNum":0,"whiteTypeNum":0,"aPlusStyles":[{"id":1},{"prompt":"clean editorial layout"}],"pointStyles":[{"id":2},{"prompt":"minimal feature callouts"}]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ai-apparel-image-set-photography-v3","x-nexscope-mcp-tool-name":"nexscope_ai_apparel_image_set_photography_v3","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/ai-model-pose-generation/run":{"post":{"tags":["Multimodal AI"],"summary":"AI Model Pose Generation API","description":"Generate model pose variations from an input image and either a pose prompt or posture reference image.","operationId":"runAiModelPoseGeneration","externalDocs":{"description":"AI Model Pose Generation API documentation","url":"https://www.nexscope.ai/api-docs/ai-model-pose-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate model pose variations from an input image and either a pose prompt or posture reference image.","properties":{"imageUrl":{"type":"string","description":"Public URL of the model image. The image must be up to 20 MB and between 385 and 4096 pixels in both width and height.","example":"https://example.com/model-reference.jpg"},"prompt":{"type":"string","description":"Text prompt describing the target pose.","example":"standing naturally with one hand holding the product"},"postureUrl":{"type":"string","description":"Optional posture reference image URL.","example":"https://example.com/pose.jpg"},"outputNum":{"type":"integer","description":"Number of images to generate, from 1 to 4. Defaults to 1.","example":1}},"required":["imageUrl"],"example":{"imageUrl":"https://example.com/model-reference.jpg","prompt":"standing naturally with one hand holding the product","postureUrl":"https://example.com/pose.jpg","outputNum":1},"additionalProperties":true},"example":{"imageUrl":"https://example.com/model-reference.jpg","prompt":"standing naturally with one hand holding the product","postureUrl":"https://example.com/pose.jpg","outputNum":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"ai-model-pose-generation","x-nexscope-mcp-tool-name":"nexscope_ai_model_pose_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/sales-talking-video/run":{"post":{"tags":["Multimodal AI"],"summary":"Sales Talking Video API","description":"Create a product-selling video from prompt and product image references.","operationId":"runSalesTalkingVideo","externalDocs":{"description":"Sales Talking Video API documentation","url":"https://www.nexscope.ai/api-docs/sales-talking-video"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Create a product-selling video from prompt and product image references.","properties":{"prompt":{"type":"string","description":"Sales script or creative prompt.","example":"Introduce this shockproof phone case in an upbeat tone."},"imageList":{"type":"array","items":{"type":"string"},"description":"Public product image URLs. Provide up to 30 images for Seedance 2.5 or up to 9 images for the other supported models.","example":["https://example.com/product.jpg"],"minItems":1,"maxItems":30},"videoType":{"type":"string","description":"Video model. Supported values: seedance-2-0, seedance-2-0-fast, seedance-2-0-mini, seedance-2-5, or happyhorse-v2.","example":"seedance-2-0-fast"},"videoTime":{"type":"integer","description":"Target duration in seconds. Seedance 2.0, Fast, Mini, and HappyHorse V2 support 5, 10, or 15; Seedance 2.5 also supports 30.","example":10},"aspectRatio":{"type":"string","description":"Target aspect ratio: 16:9, 9:16, 1:1, 4:3, 3:4, or 21:9.","example":"9:16"},"isPro":{"type":"boolean","description":"Enable Pro mode for any Seedance model. HappyHorse V2 does not support Pro mode. When enabled without resolution, the default is 720p.","example":false},"resolution":{"type":"string","description":"Target resolution. Seedance 2.0 and 2.5 support 480p, 720p, or 1080p; Seedance Fast and Mini support 480p or 720p; HappyHorse V2 supports 720p or 1080p.","example":"720p"}},"required":["prompt","imageList","videoType"],"example":{"prompt":"Introduce this shockproof phone case in an upbeat tone.","imageList":["https://example.com/product.jpg"],"videoType":"seedance-2-0-fast","videoTime":10,"aspectRatio":"9:16","isPro":false,"resolution":"720p"},"additionalProperties":true},"example":{"prompt":"Introduce this shockproof phone case in an upbeat tone.","imageList":["https://example.com/product.jpg"],"videoType":"seedance-2-0-fast","videoTime":10,"aspectRatio":"9:16","isPro":false,"resolution":"720p"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"sales-talking-video","x-nexscope-mcp-tool-name":"nexscope_sales_talking_video","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/product-logo-detection-removal/run":{"post":{"tags":["Multimodal AI"],"summary":"Product Logo Detection & Removal API","description":"Detect and optionally remove a specified brand logo from a product image.","operationId":"runProductLogoDetectionRemoval","externalDocs":{"description":"Product Logo Detection & Removal API documentation","url":"https://www.nexscope.ai/api-docs/product-logo-detection-removal"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Detect and optionally remove a specified brand logo from a product image.","properties":{"imageUrl":{"type":"string","description":"Public URL of the product image. The image must be up to 20 MB.","example":"https://example.com/product.jpg"},"brandName":{"type":"string","description":"Brand name to detect or remove.","example":"SampleBrand"},"isDetect":{"type":"boolean","description":"Whether to only detect instead of removing.","example":false}},"required":["imageUrl","brandName"],"example":{"imageUrl":"https://example.com/product.jpg","brandName":"SampleBrand","isDetect":false},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg","brandName":"SampleBrand","isDetect":false}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"product-logo-detection-removal","x-nexscope-mcp-tool-name":"nexscope_product_logo_detection_removal","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/one-click-image-recoloring-v2/run":{"post":{"tags":["Multimodal AI"],"summary":"One-Click Image Recoloring API v2","description":"Recolor the requested subject using one or more target colors.","operationId":"runOneClickImageRecoloringV2","externalDocs":{"description":"One-Click Image Recoloring API v2 documentation","url":"https://www.nexscope.ai/api-docs/one-click-image-recoloring-v2"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Recolor the requested subject using one or more target colors.","properties":{"imageUrl":{"type":"string","description":"Public URL of the product image. The image must be between 300 and 4096 pixels in both width and height.","example":"https://example.com/product.jpg"},"colors":{"type":"array","items":{"type":"string"},"description":"Target colors, from 1 to 25 entries. Each value must use full HEX (#RRGGBB), HSB (hsb(H, S%, B%)), or RGB (rgb(R, G, B)) format. Provide colors or refImageUrls, but not both.","example":["#000000","#FFFFFF"],"minItems":1,"maxItems":25},"refImageUrls":{"type":"array","items":{"type":"string"},"description":"Reference image URLs for reference-image recoloring, from 1 to 25 entries. Provide refImageUrls or colors, but not both.","example":["https://example.com/color-reference.jpg"],"minItems":1,"maxItems":25},"colorSubject":{"type":"string","description":"Subject to recolor.","example":"phone case"}},"required":["imageUrl","colorSubject"],"example":{"imageUrl":"https://example.com/product.jpg","colors":["#000000","#FFFFFF"],"colorSubject":"phone case"},"additionalProperties":true},"example":{"imageUrl":"https://example.com/product.jpg","colors":["#000000","#FFFFFF"],"colorSubject":"phone case"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"one-click-image-recoloring-v2","x-nexscope-mcp-tool-name":"nexscope_one_click_image_recoloring_v2","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/minimax-h3-video-generation/run":{"post":{"tags":["Video Generation Models"],"summary":"MiniMax H3 Video Generation","description":"Generate a MiniMax H3 video from 1 to 9 required reference images. The model is fixed by this API, so videoType must not be supplied in the request.","operationId":"runMinimaxH3VideoGeneration","externalDocs":{"description":"MiniMax H3 Video Generation documentation","url":"https://www.nexscope.ai/api-docs/minimax-h3-video-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate a MiniMax H3 video from 1 to 9 required reference images.","properties":{"videoTime":{"type":"integer","description":"Video duration in seconds. Supported values: 5, 10, 15.","example":5},"prompt":{"type":"string","description":"Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.","example":"Keep the product consistent while the camera slowly orbits and highlights material details.","maxLength":2000},"promptOptimizer":{"type":"boolean","description":"Whether Nexscope should optimize the video prompt before generation. Defaults to false.","example":false},"isPro":{"type":"boolean","description":"Whether to use the model's professional generation mode when supported. Defaults to false.","example":false},"resolution":{"type":"string","description":"Output resolution. Supported values: 768p, 2k.","example":"768p"},"imageList":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs. Provide 1 to 9 images.","example":["https://example.com/product.jpg","https://example.com/ref-2.jpg"],"minItems":1,"maxItems":9},"aspectRatio":{"type":"string","description":"Target video aspect ratio supported by this model. Supported values: adaptive, 9:16, 16:9, 1:1, 4:3, 3:4, 21:9.","example":"adaptive"}},"required":["videoTime","prompt","resolution","imageList"],"example":{"videoTime":5,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageList":["https://example.com/product.jpg","https://example.com/ref-2.jpg"],"resolution":"768p"},"additionalProperties":true},"example":{"videoTime":5,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageList":["https://example.com/product.jpg","https://example.com/ref-2.jpg"],"resolution":"768p"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"minimax-h3-video-generation","x-nexscope-mcp-tool-name":"nexscope_minimax_h3_video_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/minimax-h3-lite-video-generation/run":{"post":{"tags":["Video Generation Models"],"summary":"MiniMax H3 Lite Video Generation","description":"Generate a MiniMax H3 Lite video from 1 to 9 required reference images. The model is fixed by this API, so videoType must not be supplied in the request.","operationId":"runMinimaxH3LiteVideoGeneration","externalDocs":{"description":"MiniMax H3 Lite Video Generation documentation","url":"https://www.nexscope.ai/api-docs/minimax-h3-lite-video-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate a MiniMax H3 Lite video from 1 to 9 required reference images.","properties":{"videoTime":{"type":"integer","description":"Video duration in seconds. Supported values: 5, 10, 15.","example":5},"prompt":{"type":"string","description":"Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.","example":"Keep the product consistent while the camera slowly orbits and highlights material details.","maxLength":2000},"promptOptimizer":{"type":"boolean","description":"Whether Nexscope should optimize the video prompt before generation. Defaults to false.","example":false},"isPro":{"type":"boolean","description":"Whether to use the model's professional generation mode when supported. Defaults to false.","example":false},"resolution":{"type":"string","description":"Output resolution. Supported values: 768p.","example":"768p"},"imageList":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs. Provide 1 to 9 images.","example":["https://example.com/product.jpg","https://example.com/ref-2.jpg"],"minItems":1,"maxItems":9},"aspectRatio":{"type":"string","description":"Target video aspect ratio supported by this model. Supported values: adaptive, 9:16, 16:9, 1:1, 4:3, 3:4, 21:9.","example":"adaptive"}},"required":["videoTime","prompt","resolution","imageList"],"example":{"videoTime":5,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageList":["https://example.com/product.jpg","https://example.com/ref-2.jpg"],"resolution":"768p"},"additionalProperties":true},"example":{"videoTime":5,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageList":["https://example.com/product.jpg","https://example.com/ref-2.jpg"],"resolution":"768p"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"minimax-h3-lite-video-generation","x-nexscope-mcp-tool-name":"nexscope_minimax_h3_lite_video_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/wan-3-video-generation/run":{"post":{"tags":["Video Generation Models"],"summary":"Wan 3 Video Generation","description":"Generate a Wan 3 video from up to 10 image references, first and final frames, or a reference video. The model is fixed by this API, so videoType must not be supplied in the request.","operationId":"runWan3VideoGeneration","externalDocs":{"description":"Wan 3 Video Generation documentation","url":"https://www.nexscope.ai/api-docs/wan-3-video-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Generate a Wan 3 video from up to 10 image references, first and final frames, or a reference video.","properties":{"videoTime":{"type":"integer","description":"Video duration in seconds. Supported values: 5, 10, 15, 20, 25, 30.","example":5},"prompt":{"type":"string","description":"Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 2000 characters.","example":"Keep the product consistent while the camera slowly orbits and highlights material details.","maxLength":2000},"promptOptimizer":{"type":"boolean","description":"Whether Nexscope should optimize the video prompt before generation. Defaults to false.","example":false},"isPro":{"type":"boolean","description":"Whether to use the model's professional generation mode when supported. Defaults to false.","example":false},"resolution":{"type":"string","description":"Output resolution. Supported values: 480p, 720p, 1080p.","example":"480p"},"imageUrl":{"type":"string","description":"Public URL of a first-frame or primary reference image.","example":"https://example.com/source-image.jpg"},"imageList":{"type":"array","items":{"type":"string"},"description":"Public reference image URLs. Provide 1 to 10 images.","example":["https://example.com/product.jpg","https://example.com/ref-2.jpg"],"minItems":1,"maxItems":10},"aspectRatio":{"type":"string","description":"Target video aspect ratio supported by this model. Supported values: 16:9, 4:3, 1:1, 3:4, 9:16.","example":"16:9"},"lastFrameImageUrl":{"type":"string","description":"Optional public URL of the final-frame image. Use imageUrl for the first frame; do not combine first-and-last-frame mode with imageList or video.","example":"https://example.com/last-frame.jpg"},"video":{"type":"array","items":{"type":"string"},"description":"Optional public reference-video URL list. Reference-video mode cannot be combined with image references or a final-frame image.","example":["https://example.com/reference-video.mp4"],"minItems":1}},"required":["videoTime","prompt","resolution"],"example":{"videoTime":5,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"480p"},"additionalProperties":true},"example":{"videoTime":5,"prompt":"Keep the product consistent while the camera slowly orbits and highlights material details.","imageUrl":"https://example.com/source-image.jpg","resolution":"480p"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"wan-3-video-generation","x-nexscope-mcp-tool-name":"nexscope_wan_3_video_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/shopee-product-detail/run":{"post":{"tags":["Shopee Marketplace"],"summary":"Shopee Product Detail","description":"Returns normalized public ecommerce research data with a fixed read-only provider path.","operationId":"runShopeeProductDetail","externalDocs":{"description":"Shopee Product Detail documentation","url":"https://www.nexscope.ai/api-docs/shopee-product-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["productUrl"],"properties":{"productUrl":{"type":"string","format":"uri","pattern":"^https://(?:shopee\\.sg|shopee\\.co\\.id|shopee\\.com\\.my|shopee\\.ph|shopee\\.co\\.th|shopee\\.tw|shopee\\.vn|shopee\\.com\\.br)(?::443)?/[^?#]*-i\\.\\d+\\.\\d+/?(?:[?#].*)?$"}},"description":"Request parameters documented by ecommerce.shopee-product-detail.","example":{"productUrl":"https://shopee.sg/example-i.9641401.29691169956"}},"example":{"productUrl":"https://shopee.sg/example-i.9641401.29691169956"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","additionalProperties":false,"required":["product"],"properties":{"product":{"type":"object","additionalProperties":true,"required":["itemId","shopId"],"properties":{"itemId":{"type":"string"},"shopId":{"type":"string"},"url":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"brand":{"type":["string","object","null"]},"category":{"type":["string","object","array","null"]},"images":{"anyOf":[{"type":"array"},{"type":"null"}]},"videos":{"type":"array"},"price":{"type":["number","object","null"]},"currency":{"type":"string"},"sold":{"type":["integer","number","null"]},"rating":{"type":["number","null"]},"stock":{"type":["integer","number","object","null"]},"models":{"anyOf":[{"type":"array"},{"type":"null"}]}}}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"product":{"images":[],"models":[],"shopId":"9641401","itemId":"29691169956","name":"Example Shopee product"}},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"shopee-product-detail","x-nexscope-mcp-tool-name":"nexscope_shopee_product_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/1688-product-detail/run":{"post":{"tags":["1688 Sourcing"],"summary":"1688 Product Detail","description":"Returns normalized public ecommerce research data with a fixed read-only provider path.","operationId":"run1688ProductDetail","externalDocs":{"description":"1688 Product Detail documentation","url":"https://www.nexscope.ai/api-docs/1688-product-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["offerId"],"properties":{"offerId":{"type":"string","pattern":"^[1-9]\\d{0,999}$"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"}},"description":"Request parameters documented by ecommerce.1688-product-detail.","example":{"offerId":"1040473674152"}},"example":{"offerId":"1040473674152"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","additionalProperties":false,"required":["product"],"properties":{"product":{"type":"object","additionalProperties":true,"required":["offerId"],"properties":{"offerId":{"type":"string"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"productUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"skuList":{"anyOf":[{"type":"array"},{"type":"null"}]},"saleInfo":{"anyOf":[{"type":"object"},{"type":"null"}]},"shippingInfo":{"anyOf":[{"type":"object"},{"type":"null"}]},"companyName":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"product":{"offerId":"1040473674152","subject":"Example 1688 product","skuList":[],"companyName":"Example supplier","saleInfo":{},"shippingInfo":{}}},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"1688-product-detail","x-nexscope-mcp-tool-name":"nexscope_1688_product_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/mercado-market-intelligence/run":{"post":{"tags":["Product & Market Research"],"summary":"Mercado Market Intelligence","description":"Returns normalized public ecommerce research data with a fixed read-only provider path.","operationId":"runMercadoMarketIntelligence","externalDocs":{"description":"Mercado Market Intelligence documentation","url":"https://www.nexscope.ai/api-docs/mercado-market-intelligence"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","unevaluatedProperties":false,"required":["toolName","arguments"],"discriminator":{"propertyName":"toolName"},"oneOf":[{"properties":{"toolName":{"const":"search_categories"},"arguments":{"type":"object","additionalProperties":false,"properties":{"market_code":{"$ref":"#/$defs/marketCode"},"query":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":100}}}},"required":["toolName","arguments"]},{"properties":{"toolName":{"const":"industry_overview"},"arguments":{"type":"object","additionalProperties":false,"required":["category_id"],"properties":{"category_id":{"type":"string","minLength":1},"market_code":{"$ref":"#/$defs/marketCode"}}}},"required":["toolName","arguments"]},{"properties":{"toolName":{"const":"search_product_snapshots"},"arguments":{"$ref":"#/$defs/snapshots"}},"required":["toolName","arguments"]},{"properties":{"toolName":{"const":"product_sales_trend"},"arguments":{"type":"object","additionalProperties":false,"required":["sku_id"],"properties":{"sku_id":{"type":"string","minLength":1},"market_code":{"$ref":"#/$defs/marketCode"},"days":{"type":"integer","minimum":1,"maximum":731,"default":730}}}},"required":["toolName","arguments"]},{"properties":{"toolName":{"const":"image_search_products"},"arguments":{"type":"object","additionalProperties":false,"properties":{"image_url":{"type":"string","format":"uri","pattern":"^https?://"},"image_base64":{"type":"string","minLength":1},"market_code":{"$ref":"#/$defs/marketCode"},"page":{"type":"integer","minimum":1,"default":1},"limit":{"type":"integer","minimum":1,"default":50}},"anyOf":[{"required":["image_url"]},{"required":["image_base64"]}]}},"required":["toolName","arguments"]},{"properties":{"toolName":{"const":"review_search"},"arguments":{"type":"object","additionalProperties":false,"required":["sku_id"],"properties":{"sku_id":{"type":"string","minLength":1},"market_code":{"$ref":"#/$defs/marketCode"},"page":{"type":"integer","minimum":1,"default":1},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20}}}},"required":["toolName","arguments"]}],"$defs":{"marketCode":{"type":"string","enum":["MLM","MLB","MLA","MLC","MCO"],"default":"MLM"},"snapshots":{"type":"object","additionalProperties":false,"properties":{"market_code":{"$ref":"#/$defs/marketCode"},"keyword":{"type":"string"},"category_id":{"type":"string"},"sku_id":{"type":"string"},"product_url":{"type":"string","format":"uri","pattern":"^https?://"},"shop_id":{"type":"string"},"shop_query":{"type":"string"},"price_min":{"type":"number","minimum":0},"price_max":{"type":"number","minimum":0},"sales_30d_min":{"type":"integer","minimum":0},"sales_30d_max":{"type":"integer","minimum":0},"historical_total_sales_min":{"type":"integer","minimum":0},"historical_total_sales_max":{"type":"integer","minimum":0},"review_count_min":{"type":"integer","minimum":0},"review_count_max":{"type":"integer","minimum":0},"rating_min":{"type":"number","minimum":0,"maximum":5},"rating_max":{"type":"number","minimum":0,"maximum":5},"listing_date_min":{"type":"string","pattern":"^\\d{8}$|^\\d{4}-\\d{2}-\\d{2}$"},"listing_date_max":{"type":"string","pattern":"^\\d{8}$|^\\d{4}-\\d{2}-\\d{2}$"},"stock_type":{"type":"string"},"shop_type":{"type":"string","enum":["cross_border","local"]},"product_status":{"type":["string","integer"]},"sort_by":{"type":"string","enum":["sales_30d","historical_total_sales","price","listing_date","rating","review_count","title"],"default":"sales_30d"},"sort_order":{"type":"string","enum":["asc","desc"],"default":"desc"},"page":{"type":"integer","minimum":1,"default":1},"limit":{"type":"integer","minimum":1,"maximum":100,"default":100}},"anyOf":[{"required":["keyword"]},{"required":["category_id"]},{"required":["sku_id"]},{"required":["product_url"]},{"required":["shop_id"]},{"required":["shop_query"]}],"x-relations":["each *_min <= matching *_max"]}},"description":"Request parameters documented by ecommerce.mercado-market-intelligence.","example":{"toolName":"search_categories","arguments":{"market_code":"MLM","query":"celulares","limit":10}}},"example":{"toolName":"search_categories","arguments":{"market_code":"MLM","query":"celulares","limit":10}}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","additionalProperties":false,"required":["operation","data"],"properties":{"operation":{"type":"string","enum":["search_categories","industry_overview","search_product_snapshots","product_sales_trend","image_search_products","review_search"]},"data":{"type":"object","additionalProperties":true},"total":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"charged":{"anyOf":[{"type":"boolean"},{"type":"null"}]}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"operation":"search_categories","data":{"record_count":1,"records":[{"taxonomy_name":"Cell Phones","taxonomy_code":"MLM1055"}]},"total":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"mercado-market-intelligence","x-nexscope-mcp-tool-name":"nexscope_mercado_market_intelligence","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-video-rank/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Video Rank","description":"Returns normalized public ecommerce research data with a fixed read-only provider path.","operationId":"runTiktokVideoRank","externalDocs":{"description":"TikTok Video Rank documentation","url":"https://www.nexscope.ai/api-docs/tiktok-video-rank"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"createdByAi":{"enum":["true","false"],"type":"string"},"date":{"format":"date","type":"string"},"pageNum":{"default":1,"minimum":1,"type":"integer"},"pageSize":{"default":50,"maximum":100,"minimum":10,"multipleOf":10,"type":"integer"},"productCategoryId":{"type":"string"},"rankType":{"enum":[1,2,3],"type":"integer"},"region":{"enum":["US","ID","TH","PH","MY","VN","GB","MX","SG","SA","BR","ES","JP","DE","IT","FR"],"type":"string"},"videoRankField":{"enum":[1,2],"type":"integer"}},"required":["date","rankType","region","videoRankField"],"type":"object"},"example":{"date":"2026-08-26","pageNum":1,"pageSize":50,"rankType":1,"region":"US","videoRankField":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","additionalProperties":false,"required":["videos","total"],"properties":{"videos":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"videoId":{"anyOf":[{"type":"string"},{"type":"null"}]},"officialUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalViewsCnt":{"anyOf":[{"type":["integer","number"]},{"type":"null"}]}}}},"total":{"type":"integer","minimum":0}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"videos":[{"videoId":"example-video-id","totalViewsCnt":1,"region":"US"}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-video-rank","x-nexscope-mcp-tool-name":"nexscope_tiktok_video_rank","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/etsy-product-detail/run":{"post":{"tags":["Etsy Marketplace"],"summary":"Etsy Product Detail","description":"Returns normalized public ecommerce research data with a fixed read-only provider path.","operationId":"runEtsyProductDetail","externalDocs":{"description":"Etsy Product Detail documentation","url":"https://www.nexscope.ai/api-docs/etsy-product-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["productUrl"],"properties":{"productUrl":{"type":"string","format":"uri","pattern":"^https://(?:[A-Za-z0-9-]+\\.)*etsy\\.com(?::443)?/listing/\\d+(?:/[^/?#]+)?/?(?:[?#].*)?$"}},"description":"Request parameters documented by ecommerce.etsy-product-detail.","example":{"productUrl":"https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt"}},"example":{"productUrl":"https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","additionalProperties":false,"required":["product"],"properties":{"product":{"type":"object","additionalProperties":true,"required":["productId"],"properties":{"productId":{"type":"string"},"productUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"array"},{"type":"null"}]},"images":{"anyOf":[{"type":"array"},{"type":"null"}]},"price":{"anyOf":[{"type":"string"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"shopId":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"product":{"images":[],"currency":"EUR","productId":"1710567856","price":"24.99","title":"Example Etsy product"}},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"etsy-product-detail","x-nexscope-mcp-tool-name":"nexscope_etsy_product_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/google-patent-search/run":{"post":{"tags":["Patent & IP Risk"],"summary":"Google Patent Search","description":"Returns normalized public ecommerce research data with a fixed read-only provider path.","operationId":"runGooglePatentSearch","externalDocs":{"description":"Google Patent Search documentation","url":"https://www.nexscope.ai/api-docs/google-patent-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["q"],"properties":{"q":{"type":"string","minLength":1,"maxLength":1000},"num":{"type":"integer","minimum":10,"maximum":100,"default":10},"page":{"type":"integer","minimum":1,"default":1},"country":{"type":"string"},"language":{"type":"string"},"before":{"type":"string","pattern":"^(priority|filing|publication):\\d{8}$"},"after":{"type":"string","pattern":"^(priority|filing|publication):\\d{8}$"},"sort":{"type":"string","enum":["new","old"]},"type":{"type":"string","enum":["PATENT","DESIGN"]},"status":{"type":"string","enum":["GRANT","APPLICATION"]},"patents":{"type":"boolean","default":true},"scholar":{"type":"boolean","default":false},"litigation":{"type":"string","enum":["YES","NO"]},"inventor":{"type":"string"},"assignee":{"type":"string"},"clustered":{"const":true},"dups":{"const":"language"}},"description":"Request parameters documented by ecommerce.google-patent-search.","example":{"q":"wireless earbuds","num":10,"page":1}},"example":{"q":"wireless earbuds","num":10,"page":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","additionalProperties":false,"required":["results"],"properties":{"results":{"type":"array","items":{"type":"object","additionalProperties":true}},"searchInformation":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"pagination":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"summary":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"summary":{"cpc":[{"key":"Total","percentage":100}]},"results":[]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"google-patent-search","x-nexscope-mcp-tool-name":"nexscope_google_patent_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/walmart-category-market/run":{"post":{"tags":["Walmart Marketplace Intelligence"],"summary":"Walmart Category Market","description":"Returns normalized public ecommerce research data with a fixed read-only provider path.","operationId":"runWalmartCategoryMarket","externalDocs":{"description":"Walmart Category Market documentation","url":"https://www.nexscope.ai/api-docs/walmart-category-market"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","unevaluatedProperties":false,"required":["operation"],"discriminator":{"propertyName":"operation"},"oneOf":[{"properties":{"operation":{"const":"tree"}},"required":["operation"]},{"properties":{"operation":{"const":"searchByName"},"name":{"type":"string","minLength":1}},"required":["operation","name"]},{"properties":{"operation":{"const":"marketReport"},"nodePath":{"type":"string","pattern":"^\\d+(?:_\\d+)+$"}},"required":["operation","nodePath"]}],"description":"Request parameters documented by ecommerce.walmart-category-market.","example":{"operation":"tree"}},"example":{"operation":"tree"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","additionalProperties":false,"required":["operation","value","requestConsumed"],"properties":{"operation":{"type":"string"},"value":{},"requestConsumed":{"type":"integer","minimum":0}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"operation":"tree","value":[{"NodeId":"1005862","Name":"Personal Care"}],"requestConsumed":5},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"walmart-category-market","x-nexscope-mcp-tool-name":"nexscope_walmart_category_market","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/walmart-keyword-research/run":{"post":{"tags":["Walmart Marketplace Intelligence"],"summary":"Walmart Keyword Research","description":"Returns normalized public ecommerce research data with a fixed read-only provider path.","operationId":"runWalmartKeywordResearch","externalDocs":{"description":"Walmart Keyword Research documentation","url":"https://www.nexscope.ai/api-docs/walmart-keyword-research"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","unevaluatedProperties":false,"required":["operation"],"discriminator":{"propertyName":"operation"},"oneOf":[{"properties":{"operation":{"const":"marketQuery"},"pattern":{"$ref":"#/$defs/pattern"},"pageIndex":{"$ref":"#/$defs/page"},"pageSize":{"$ref":"#/$defs/pageSize"}},"required":["operation"]},{"properties":{"operation":{"const":"searchByName"},"name":{"type":"string","minLength":1},"pageIndex":{"$ref":"#/$defs/page"}},"required":["operation","name"]},{"properties":{"operation":{"const":"searchProducts"},"keyword":{"type":"string","minLength":1},"pageIndex":{"$ref":"#/$defs/page"},"pageSize":{"$ref":"#/$defs/pageSize"}},"required":["operation","keyword"]},{"properties":{"operation":{"const":"detail"},"keyword":{"type":"string","minLength":1}},"required":["operation","keyword"]},{"properties":{"operation":{"const":"productKeywords"},"productId":{"type":"string","minLength":1},"pageIndex":{"$ref":"#/$defs/page"},"pageSize":{"$ref":"#/$defs/pageSize"}},"required":["operation","productId"]},{"properties":{"operation":{"const":"relatedKeywords"},"keyword":{"type":"string","minLength":1},"pageIndex":{"$ref":"#/$defs/page"},"pageSize":{"$ref":"#/$defs/pageSize"}},"required":["operation","keyword"]},{"properties":{"operation":{"const":"favoriteList"},"command":{"oneOf":[{"enum":["all","dict"]},{"type":"string","pattern":"^dict=.+$"}]},"pageIndex":{"$ref":"#/$defs/page"}},"required":["operation","command"]}],"$defs":{"page":{"type":"integer","minimum":1,"default":1},"pageSize":{"type":"integer","minimum":20,"maximum":200,"default":20},"range":{"type":"array","items":{"type":"integer","minimum":0},"minItems":1,"maxItems":2,"x-relation":"first <= second"},"pattern":{"type":"object","additionalProperties":false,"properties":{"keyword":{"type":"string","minLength":1},"rankCondition":{"$ref":"#/$defs/range"},"searchVolumeCondition":{"$ref":"#/$defs/range"}}}},"description":"Request parameters documented by ecommerce.walmart-keyword-research.","example":{"operation":"searchByName","name":"wireless earbuds","pageIndex":1}},"example":{"operation":"searchByName","name":"wireless earbuds","pageIndex":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","additionalProperties":false,"required":["operation","value","requestConsumed"],"properties":{"operation":{"type":"string"},"value":{},"requestConsumed":{"type":"integer","minimum":0}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"operation":"searchByName","value":[{"SearchVolume":1,"Rank":1,"Keyword":"wireless earbuds"}],"requestConsumed":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"walmart-keyword-research","x-nexscope-mcp-tool-name":"nexscope_walmart_keyword_research","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/walmart-product-analysis/run":{"post":{"tags":["Walmart Marketplace Intelligence"],"summary":"Walmart Product Analysis","description":"Returns normalized public ecommerce research data with a fixed read-only provider path.","operationId":"runWalmartProductAnalysis","externalDocs":{"description":"Walmart Product Analysis documentation","url":"https://www.nexscope.ai/api-docs/walmart-product-analysis"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","unevaluatedProperties":false,"required":["operation"],"discriminator":{"propertyName":"operation"},"oneOf":[{"properties":{"operation":{"const":"searchByName"},"name":{"type":"string","minLength":1},"pageIndex":{"type":"integer","minimum":1,"default":1}},"required":["operation","name"]},{"properties":{"operation":{"const":"detail"},"productId":{"type":"string","minLength":1}},"required":["operation","productId"]},{"properties":{"operation":{"const":"trend"},"productId":{"type":"string","minLength":1}},"required":["operation","productId"]},{"properties":{"operation":{"const":"salesVolume"},"productId":{"type":"string","minLength":1},"queryDate":{"type":"string","format":"date"},"queryEndDate":{"type":"string","format":"date"},"pageIndex":{"type":"integer","minimum":1,"default":1}},"required":["operation","productId"],"x-relations":["queryDate <= queryEndDate; defaults to latest 30 days; start-only ends today"]}],"description":"Request parameters documented by ecommerce.walmart-product-analysis.","example":{"operation":"detail","productId":"5169493923"}},"example":{"operation":"detail","productId":"5169493923"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","additionalProperties":false,"required":["operation","value","requestConsumed"],"properties":{"operation":{"type":"string"},"value":{},"requestConsumed":{"type":"integer","minimum":0}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"operation":"detail","value":{"ProductId":"5169493923","Price":1,"Title":"Example Walmart product"},"requestConsumed":1},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"walmart-product-analysis","x-nexscope-mcp-tool-name":"nexscope_walmart_product_analysis","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/tiktok-shop-product-detail/run":{"post":{"tags":["TikTok / Social Commerce"],"summary":"TikTok Shop Product Detail","description":"Returns normalized public ecommerce research data with a fixed read-only provider path.","operationId":"runTiktokShopProductDetail","externalDocs":{"description":"TikTok Shop Product Detail documentation","url":"https://www.nexscope.ai/api-docs/tiktok-shop-product-detail"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["productInput"],"properties":{"productInput":{"type":"string","oneOf":[{"pattern":"^\\d{19}$"},{"format":"uri","pattern":"^https://(?:[A-Za-z0-9-]+\\.)*tiktok\\.com(?::443)?/(?:.*/)?product/\\d{19}(?:[/?#].*)?$"}]},"region":{"type":"string","enum":["US","GB","ID","MY","TH","VN","PH","SG","DE","FR","IT","ES"],"default":"US"}},"description":"Request parameters documented by ecommerce.tiktok-shop-product-detail.","example":{"productInput":"1729937400435937604","region":"US"}},"example":{"productInput":"1729937400435937604","region":"US"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","additionalProperties":false,"required":["product"],"properties":{"product":{"type":"object","additionalProperties":true,"required":["productId"],"properties":{"productId":{"type":"string","pattern":"^\\d{19}$"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"seller":{"anyOf":[{"type":"object"},{"type":"null"}]},"pricing":{"anyOf":[{"type":"object"},{"type":"null"}]},"sales":{"anyOf":[{"type":"object"},{"type":"null"}]},"inventory":{"anyOf":[{"type":"object"},{"type":"null"}]},"media":{"anyOf":[{"type":"object"},{"type":"null"}]}}}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"product":{"seller":{"name":"CARER SPARK"},"title":"Example TikTok Shop product","productId":"1729937400435937604"}},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"tiktok-shop-product-detail","x-nexscope-mcp-tool-name":"nexscope_tiktok_shop_product_detail","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-keyword-metrics/run":{"post":{"tags":["Search & Trend Intelligence"],"summary":"SEO Keyword Metrics","description":"Keyword metrics with explicit coverage for every input. Calls are idempotent by user, slug and UUID key. Free owner-only result retrieval: GET /api/skill-api/v1/skills/seo-keyword-metrics/calls/{callId} or nexscope_seo_call_result. Successful results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests. Missing values are not zero. Examples describe structure only and are not measured results.","operationId":"runSeoKeywordMetrics","externalDocs":{"description":"SEO Keyword Metrics documentation","url":"https://www.nexscope.ai/api-docs/seo-keyword-metrics"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"market":{"enum":["US"],"type":"string"},"language":{"enum":["en"],"type":"string"},"keywords":{"maxItems":20,"type":"array","items":{"description":"Trimmed, at most ten whitespace-separated words.","maxLength":80,"type":"string","minLength":1},"minItems":1}},"type":"object","required":["market","language","keywords"]},"example":{"language":"en","keywords":["hiking bottle"],"market":"US"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false},"result":{"anyOf":[{"properties":{"market":{"type":["string","null"]},"language":{"type":["string","null"]},"items":{"items":{"properties":{"inputIndex":{"type":["integer","null"]},"inputKeyword":{"type":["string","null"]},"normalizedKeyword":{"type":["string","null"]},"status":{"enum":["AVAILABLE","NO_COVERAGE"],"type":"string"},"searchVolume":{"type":["integer","null"]},"cpcUsd":{"type":["string","null"]},"competition":{"type":["number","null"]},"competitionLevel":{"type":["string","null"]},"keywordDifficulty":{"type":["number","null"]},"monthlySearches":{"items":{"properties":{"year":{"type":["integer","null"]},"month":{"type":["integer","null"]},"searchVolume":{"type":["integer","null"]}},"type":"object"},"type":"array"},"dataUpdatedAt":{"type":["integer","null"]},"missing":{"items":{"properties":{"field":{"type":["string","null"]},"reason":{"type":["string","null"]}},"type":"object"},"type":"array"}},"type":"object"},"type":"array"}},"type":"object"},{"type":"null"}]},"reason":{"description":"Stable reason on errors 42001 through 42011; accepted errors retain callId.","type":"string"},"retryable":{"const":false,"type":"boolean"}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-keyword-metrics","x-nexscope-mcp-tool-name":"nexscope_seo_keyword_metrics","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-keyword-expand/run":{"post":{"tags":["Search & Trend Intelligence"],"summary":"SEO Keyword Expansion","description":"Deduplicated suggestions and related keywords with source relationships. Calls are idempotent by user, slug and UUID key. Free owner-only result retrieval: GET /api/skill-api/v1/skills/seo-keyword-expand/calls/{callId} or nexscope_seo_call_result. Successful results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests. Missing values are not zero. Examples describe structure only and are not measured results.","operationId":"runSeoKeywordExpand","externalDocs":{"description":"SEO Keyword Expansion documentation","url":"https://www.nexscope.ai/api-docs/seo-keyword-expand"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"market":{"enum":["US"],"type":"string"},"language":{"enum":["en"],"type":"string"},"keyword":{"description":"Trimmed, at most ten whitespace-separated words.","maxLength":80,"type":"string","minLength":1},"limit":{"type":"integer","default":10,"maximum":20,"minimum":1},"sources":{"minItems":1,"type":"array","maxItems":2,"items":{"enum":["suggestions","related"],"type":"string"},"default":["suggestions","related"],"uniqueItems":true}},"type":"object","required":["market","language","keyword"]},"example":{"keyword":"hiking bottle","language":"en","market":"US"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false},"result":{"anyOf":[{"properties":{"seed":{"type":["string","null"]},"market":{"type":["string","null"]},"language":{"type":["string","null"]},"requestedLimit":{"type":["integer","null"]},"returnedCount":{"type":["integer","null"]},"items":{"items":{"properties":{"keyword":{"type":["string","null"]},"relations":{"items":{"properties":{"source":{"type":["string","null"]},"seed":{"type":["string","null"]},"depth":{"type":["integer","null"]}},"type":"object"},"type":"array"},"searchVolume":{"type":["integer","null"]},"keywordDifficulty":{"type":["number","null"]},"missing":{"items":{"properties":{"field":{"type":["string","null"]},"reason":{"type":["string","null"]}},"type":"object"},"type":"array"}},"type":"object"},"type":"array"},"sources":{"items":{"properties":{"source":{"type":["string","null"]},"status":{"type":["string","null"]},"returnedCount":{"type":["integer","null"]},"missingReason":{"type":["string","null"]}},"type":"object"},"type":"array"}},"type":"object"},{"type":"null"}]},"reason":{"description":"Stable reason on errors 42001 through 42011; accepted errors retain callId.","type":"string"},"retryable":{"const":false,"type":"boolean"}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-keyword-expand","x-nexscope-mcp-tool-name":"nexscope_seo_keyword_expand","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-serp/run":{"post":{"tags":["Search & Trend Intelligence"],"summary":"SEO SERP","description":"Google result types and original ranks for US English desktop searches. Calls are idempotent by user, slug and UUID key. Free owner-only result retrieval: GET /api/skill-api/v1/skills/seo-serp/calls/{callId} or nexscope_seo_call_result. Successful results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests. Missing values are not zero. Examples describe structure only and are not measured results.","operationId":"runSeoSerp","externalDocs":{"description":"SEO SERP documentation","url":"https://www.nexscope.ai/api-docs/seo-serp"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"market":{"enum":["US"],"type":"string"},"language":{"enum":["en"],"type":"string"},"keyword":{"description":"Trimmed, at most ten whitespace-separated words.","maxLength":80,"type":"string","minLength":1},"limit":{"type":"integer","default":10,"maximum":10,"minimum":1},"device":{"default":"desktop","type":"string","enum":["desktop"]}},"type":"object","required":["market","language","keyword"]},"example":{"keyword":"hiking bottle","language":"en","market":"US"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false},"result":{"anyOf":[{"properties":{"keyword":{"type":["string","null"]},"market":{"type":["string","null"]},"language":{"type":["string","null"]},"device":{"type":["string","null"]},"requestedLimit":{"type":["integer","null"]},"collectedAt":{"type":["integer","null"]},"items":{"items":{"properties":{"type":{"type":["string","null"]},"rankGroup":{"type":["integer","null"]},"rankAbsolute":{"type":["integer","null"]},"title":{"type":["string","null"]},"url":{"type":["string","null"]},"domain":{"type":["string","null"]},"description":{"type":["string","null"]},"missing":{"items":{"properties":{"field":{"type":["string","null"]},"reason":{"type":["string","null"]}},"type":"object"},"type":"array"}},"type":"object"},"type":"array"}},"type":"object"},{"type":"null"}]},"reason":{"description":"Stable reason on errors 42001 through 42011; accepted errors retain callId.","type":"string"},"retryable":{"const":false,"type":"boolean"}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-serp","x-nexscope-mcp-tool-name":"nexscope_seo_serp","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-page-evidence/run":{"post":{"tags":["Search & Trend Intelligence"],"summary":"SEO Page Evidence","description":"Bounded page evidence with separate collection snapshots and missing reasons. Calls are idempotent by user, slug and UUID key. Free owner-only result retrieval: GET /api/skill-api/v1/skills/seo-page-evidence/calls/{callId} or nexscope_seo_call_result. Successful results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests. Missing values are not zero. Examples describe structure only and are not measured results.","operationId":"runSeoPageEvidence","externalDocs":{"description":"SEO Page Evidence documentation","url":"https://www.nexscope.ai/api-docs/seo-page-evidence"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"url":{"description":"Public HTTP(S) URL only; no credentials, IP literals or nonstandard ports.","maxLength":2048,"type":"string","minLength":1}},"type":"object","required":["url"]},"example":{"url":"https://example.com/"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false},"result":{"anyOf":[{"properties":{"requestedUrl":{"type":["string","null"]},"snapshots":{"items":{"properties":{"id":{"type":["string","null"]},"sourceEndpoint":{"type":["string","null"]},"capturedAt":{"type":["integer","null"]},"status":{"type":["string","null"]},"finalUrl":{"type":["string","null"]},"evidence":{"anyOf":[{"properties":{"httpStatus":{"type":["integer","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"canonical":{"type":["string","null"]},"h1":{"items":{"type":["string","null"]},"type":"array"},"metaRobots":{"items":{"type":["string","null"]},"type":"array"},"textLength":{"type":["integer","null"]},"html":{"properties":{"content":{"type":["string","null"]},"truncated":{"type":"boolean"},"sha256":{"type":["string","null"]}},"type":"object"}},"type":"object"},{"properties":{"title":{"type":["string","null"]},"text":{"type":["string","null"]},"links":{"items":{"properties":{"url":{"type":["string","null"]},"text":{"type":["string","null"]}},"type":"object"},"type":"array"},"textTruncated":{"type":"boolean"},"linksTruncated":{"type":"boolean"}},"type":"object"}]},"missing":{"items":{"properties":{"field":{"type":["string","null"]},"reason":{"type":["string","null"]}},"type":"object"},"type":"array"}},"type":"object"},"type":"array"}},"type":"object"},{"type":"null"}]},"reason":{"description":"Stable reason on errors 42001 through 42011; accepted errors retain callId.","type":"string"},"retryable":{"const":false,"type":"boolean"}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-page-evidence","x-nexscope-mcp-tool-name":"nexscope_seo_page_evidence","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-keyword-intent/run":{"post":{"tags":["Search & Trend Intelligence"],"summary":"Keyword Intent","description":"Keyword Intent with explicit missing evidence and bounded keyword inputs. Uses one fixed Nexscope task. Schema C1-1.0. Idempotent calls preserve original input order. Free owner-only retrieval: GET /api/skill-api/v1/skills/seo-keyword-intent/calls/{callId} or nexscope_seo_call_result. Successful results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests. Missing values are not zero. No execution or publication is implied.","operationId":"runSeoKeywordIntent","externalDocs":{"description":"Keyword Intent documentation","url":"https://www.nexscope.ai/api-docs/seo-keyword-intent"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"keywords":{"maxItems":20,"type":"array","items":{"minLength":1,"type":"string"},"minItems":1},"language":{"const":"en","type":"string"}},"type":"object","required":["keywords","language"]},"example":{"language":"en","keywords":["wireless earbuds"]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false},"result":{"anyOf":[{"additionalProperties":false,"properties":{"language":{"const":"en","type":"string"},"items":{"maxItems":20,"type":"array","items":{"additionalProperties":false,"properties":{"inputIndex":{"maximum":19,"minimum":0,"type":"integer"},"inputKeyword":{"type":"string"},"normalizedKeyword":{"type":"string"},"status":{"enum":["AVAILABLE","NO_COVERAGE"],"type":"string"},"primaryIntent":{"anyOf":[{"additionalProperties":false,"properties":{"label":{"enum":["informational","navigational","commercial","transactional"],"type":"string"},"probability":{"maximum":1,"minimum":0,"type":["number","null"]}},"type":"object","required":["label","probability"]},{"type":"null"}]},"secondaryIntents":{"items":{"additionalProperties":false,"properties":{"label":{"enum":["informational","navigational","commercial","transactional"],"type":"string"},"probability":{"maximum":1,"minimum":0,"type":["number","null"]}},"type":"object","required":["label","probability"]},"type":"array"},"missing":{"items":{"additionalProperties":false,"properties":{"field":{"minLength":1,"type":"string"},"reason":{"enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_KEYWORD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_KEYWORD"],"type":"string"}},"type":"object","required":["field","reason"]},"type":"array"}},"type":"object","required":["inputIndex","inputKeyword","normalizedKeyword","status","primaryIntent","secondaryIntents","missing"]},"minItems":1}},"type":"object","required":["language","items"]},{"type":"null"}]}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-keyword-intent","x-nexscope-mcp-tool-name":"nexscope_seo_keyword_intent","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-keyword-ideas/run":{"post":{"tags":["Search & Trend Intelligence"],"summary":"Category-based Keyword Ideas","description":"Category-based Keyword Ideas with explicit missing evidence and bounded keyword inputs. Uses one fixed Nexscope task. Schema C1-1.0. Idempotent calls preserve original input order. Free owner-only retrieval: GET /api/skill-api/v1/skills/seo-keyword-ideas/calls/{callId} or nexscope_seo_call_result. Successful results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests. Missing values are not zero. No execution or publication is implied.","operationId":"runSeoKeywordIdeas","externalDocs":{"description":"Category-based Keyword Ideas documentation","url":"https://www.nexscope.ai/api-docs/seo-keyword-ideas"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"keywords":{"maxItems":20,"type":"array","items":{"minLength":1,"type":"string"},"minItems":1},"language":{"const":"en","type":"string"},"market":{"const":"US","type":"string"},"limit":{"type":"integer","default":10,"maximum":20,"minimum":1}},"type":"object","required":["keywords","language","market"]},"example":{"language":"en","market":"US","keywords":["wireless earbuds"]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false},"result":{"anyOf":[{"additionalProperties":false,"properties":{"seeds":{"maxItems":20,"type":"array","items":{"type":"string"},"minItems":1},"market":{"const":"US","type":"string"},"language":{"const":"en","type":"string"},"relationSource":{"const":"category","type":"string"},"requestedLimit":{"maximum":20,"minimum":1,"type":"integer"},"returnedCount":{"maximum":20,"minimum":0,"type":"integer"},"items":{"maxItems":20,"type":"array","items":{"additionalProperties":false,"properties":{"keyword":{"minLength":1,"type":"string"},"categoryIds":{"items":{"maximum":2147483647,"minimum":1,"type":"integer"},"type":"array","uniqueItems":true},"searchVolume":{"minimum":0,"type":["integer","null"]},"cpcUsd":{"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$","type":["string","null"]},"competition":{"maximum":1,"minimum":0,"type":["number","null"]},"missing":{"items":{"additionalProperties":false,"properties":{"field":{"minLength":1,"type":"string"},"reason":{"enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_KEYWORD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_KEYWORD"],"type":"string"}},"type":"object","required":["field","reason"]},"type":"array"}},"type":"object","required":["keyword","categoryIds","searchVolume","cpcUsd","competition","missing"]},"minItems":0},"missing":{"items":{"additionalProperties":false,"properties":{"field":{"minLength":1,"type":"string"},"reason":{"enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_KEYWORD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_KEYWORD"],"type":"string"}},"type":"object","required":["field","reason"]},"type":"array"}},"type":"object","required":["seeds","market","language","relationSource","requestedLimit","returnedCount","items","missing"]},{"type":"null"}]}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-keyword-ideas","x-nexscope-mcp-tool-name":"nexscope_seo_keyword_ideas","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-keyword-categories/run":{"post":{"tags":["Search & Trend Intelligence"],"summary":"Keyword Categories","description":"Keyword Categories with explicit missing evidence and bounded keyword inputs. Uses one fixed Nexscope task. Schema C1-1.0. Idempotent calls preserve original input order. Free owner-only retrieval: GET /api/skill-api/v1/skills/seo-keyword-categories/calls/{callId} or nexscope_seo_call_result. Successful results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests. Missing values are not zero. No execution or publication is implied.","operationId":"runSeoKeywordCategories","externalDocs":{"description":"Keyword Categories documentation","url":"https://www.nexscope.ai/api-docs/seo-keyword-categories"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"keywords":{"maxItems":20,"type":"array","items":{"minLength":1,"type":"string"},"minItems":1},"language":{"const":"en","type":"string"}},"type":"object","required":["keywords","language"]},"example":{"language":"en","keywords":["wireless earbuds"]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false},"result":{"anyOf":[{"additionalProperties":false,"properties":{"language":{"const":"en","type":"string"},"taxonomy":{"const":"google_product_service","type":"string"},"items":{"maxItems":20,"type":"array","items":{"additionalProperties":false,"properties":{"inputIndex":{"maximum":19,"minimum":0,"type":"integer"},"inputKeyword":{"type":"string"},"normalizedKeyword":{"type":"string"},"status":{"enum":["AVAILABLE","NO_COVERAGE"],"type":"string"},"categoryIds":{"items":{"maximum":2147483647,"minimum":1,"type":"integer"},"type":"array","uniqueItems":true},"missing":{"items":{"additionalProperties":false,"properties":{"field":{"minLength":1,"type":"string"},"reason":{"enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_KEYWORD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_KEYWORD"],"type":"string"}},"type":"object","required":["field","reason"]},"type":"array"}},"type":"object","required":["inputIndex","inputKeyword","normalizedKeyword","status","categoryIds","missing"]},"minItems":1}},"type":"object","required":["language","taxonomy","items"]},{"type":"null"}]}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-keyword-categories","x-nexscope-mcp-tool-name":"nexscope_seo_keyword_categories","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-keyword-history/run":{"post":{"tags":["Keywords & Trends"],"summary":"Keyword Historical Profile Snapshots","description":"Keyword Historical Profile Snapshots. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoKeywordHistory","externalDocs":{"description":"Keyword Historical Profile Snapshots documentation","url":"https://www.nexscope.ai/api-docs/seo-keyword-history"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keywords":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80},"minItems":1,"maxItems":20},"fromMonth":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"toMonth":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"}},"required":["keywords","fromMonth","toMonth"],"additionalProperties":false},"example":{"toMonth":"2026-03","fromMonth":"2026-01","keywords":[" C ","d"]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"keywords":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":20},"normalizedKeywords":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":20},"fromMonth":{"type":"string"},"toMonth":{"type":"string"},"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"dataforseo_labs"},"engine":{"type":"string","const":"google"},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"history":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"searchVolume":{"type":["integer","null"],"minimum":0},"cpcUsd":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"paidCompetition":{"type":["number","null"],"minimum":0,"maximum":1},"metricsUpdatedAt":{"type":["integer","null"],"minimum":0},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["year","month","searchVolume","cpcUsd","paidCompetition","metricsUpdatedAt","missing"],"additionalProperties":false},"minItems":0,"maxItems":12},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["keyword","history","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"metricSource":{"type":"string","const":"google_ads_historical_keyword_profile"},"timeGranularity":{"type":"string","const":"month"}},"required":["keywords","normalizedKeywords","fromMonth","toMonth","market","language","sourceProduct","engine","returnedCount","items","missing","truncated","metricSource","timeGranularity"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-keyword-history","x-nexscope-mcp-tool-name":"nexscope_seo_keyword_history","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-site-keywords/run":{"post":{"tags":["Keywords & Trends"],"summary":"Site Category Related Keywords","description":"Site Category Related Keywords. Bounded Nexscope database facts with explicit missing evidence. One fixed task; no pagination. Missing values are not zero. Prices and publication are unapproved. Successful owner-only results remain available in call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoSiteKeywords","externalDocs":{"description":"Site Category Related Keywords documentation","url":"https://www.nexscope.ai/api-docs/seo-site-keywords"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10},"target":{"type":"string","minLength":1,"maxLength":254}},"required":["target"],"additionalProperties":false},"example":{"target":" Example.COM. ","limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"requestedLimit":{"type":"integer","minimum":1,"maximum":20},"returnedCount":{"type":"integer","minimum":0,"maximum":20},"inputTarget":{"type":"string"},"target":{"type":"string"},"relationSource":{"type":"string","const":"site_category"},"includeSubdomains":{"type":"boolean","const":true},"ordering":{"type":"string","const":"relevance_desc"},"items":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string","minLength":1},"categoryIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"minItems":0,"uniqueItems":true},"searchVolume":{"type":["integer","null"],"minimum":0},"cpcUsd":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"competition":{"type":["number","null"],"minimum":0,"maximum":1},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["keyword","categoryIds","searchVolume","cpcUsd","competition","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["market","language","requestedLimit","returnedCount","inputTarget","target","relationSource","includeSubdomains","ordering","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-site-keywords","x-nexscope-mcp-tool-name":"nexscope_seo_site_keywords","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-category-keywords/run":{"post":{"tags":["Keywords & Trends"],"summary":"Category Keywords","description":"Category Keywords. Bounded Nexscope database facts with explicit missing evidence. One fixed task; no pagination. Missing values are not zero. Prices and publication are unapproved. Successful owner-only results remain available in call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoCategoryKeywords","externalDocs":{"description":"Category Keywords documentation","url":"https://www.nexscope.ai/api-docs/seo-category-keywords"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10},"categoryIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"minItems":1,"maxItems":20},"categoryMatch":{"type":"string","enum":["ALL","ANY"],"default":"ALL"}},"required":["categoryIds"],"additionalProperties":false},"example":{"categoryMatch":"ALL","limit":3,"categoryIds":[12191,12193]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"requestedLimit":{"type":"integer","minimum":1,"maximum":20},"returnedCount":{"type":"integer","minimum":0,"maximum":20},"categoryIds":{"type":"array","items":{"type":"integer","minimum":1},"minItems":1,"maxItems":20},"normalizedCategoryIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"minItems":0,"uniqueItems":true},"categoryMatch":{"type":"string","enum":["ALL","ANY"]},"taxonomy":{"type":"string","const":"google_product_service"},"ordering":{"type":"string","const":"search_volume_desc"},"items":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string","minLength":1},"categoryIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"minItems":0,"uniqueItems":true},"searchVolume":{"type":["integer","null"],"minimum":0},"cpcUsd":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"competition":{"type":["number","null"],"minimum":0,"maximum":1},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["keyword","categoryIds","searchVolume","cpcUsd","competition","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["market","language","requestedLimit","returnedCount","categoryIds","normalizedCategoryIds","categoryMatch","taxonomy","ordering","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-category-keywords","x-nexscope-mcp-tool-name":"nexscope_seo_category_keywords","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-top-searches/run":{"post":{"tags":["Keywords & Trends"],"summary":"High Search Volume Database Keywords","description":"High Search Volume Database Keywords. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoTopSearches","externalDocs":{"description":"High Search Volume Database Keywords documentation","url":"https://www.nexscope.ai/api-docs/seo-top-searches"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":[],"minProperties":1,"additionalProperties":false},"example":{"limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"dataforseo_labs"},"engine":{"type":"string","const":"google"},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"searchVolume":{"type":["integer","null"],"minimum":0},"cpcUsd":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"paidCompetition":{"type":["number","null"],"minimum":0,"maximum":1},"metricsUpdatedAt":{"type":["integer","null"],"minimum":0},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["keyword","searchVolume","cpcUsd","paidCompetition","metricsUpdatedAt","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"requestedLimit":{"type":"integer","minimum":1,"maximum":20},"rankingBasis":{"type":"string","const":"google_ads_search_volume"},"ordering":{"type":"string","const":"search_volume_desc"},"freshness":{"type":"string","const":"database_latest_available"}},"required":["market","language","sourceProduct","engine","returnedCount","items","missing","truncated","requestedLimit","rankingBasis","ordering","freshness"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-top-searches","x-nexscope-mcp-tool-name":"nexscope_seo_top_searches","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-clickstream-search-volume/run":{"post":{"tags":["Keywords & Trends"],"summary":"Clickstream Search Volume","description":"clickstream estimate with explicit missing evidence and no language filter. One fixed Live task, no additional requests. Estimates are not Google Ads metrics. Prices remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoClickstreamSearchVolume","externalDocs":{"description":"Clickstream Search Volume documentation","url":"https://www.nexscope.ai/api-docs/seo-clickstream-search-volume"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keywords":{"type":"array","items":{"type":"string","minLength":1,"description":"After Unicode trim, 3 to 80 ASCII letters, digits, ordinary spaces, apostrophes or hyphens; at least one letter or digit; at most ten words."},"minItems":1,"maxItems":20},"market":{"type":"string","const":"US","default":"US"}},"required":["keywords"],"additionalProperties":false},"example":{"keywords":[" Shoes ","shoes"]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"inputKeywords":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":20},"normalizedKeywords":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":20},"sourceProduct":{"type":"string","const":"keywords_data"},"sourceKind":{"type":"string","const":"clickstream_estimate"},"marketScope":{"type":"string","const":"US"},"languageFilter":{"type":"null"},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"averageMonthlySearches":{"type":["integer","null"],"minimum":0},"months":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"searchVolume":{"type":["integer","null"],"minimum":0},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["year","month","searchVolume","missing"],"additionalProperties":false},"minItems":0,"maxItems":12},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["keyword","averageMonthlySearches","months","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["inputKeywords","normalizedKeywords","sourceProduct","sourceKind","marketScope","languageFilter","returnedCount","truncated","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-clickstream-search-volume","x-nexscope-mcp-tool-name":"nexscope_seo_clickstream_search_volume","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-search-volume-country-distribution/run":{"post":{"tags":["Keywords & Trends"],"summary":"Clickstream Country Search Volume Distribution","description":"clickstream country distribution with explicit missing evidence and no language filter. One fixed Live task, no additional requests. Estimates are not Google Ads metrics. Prices remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoSearchVolumeCountryDistribution","externalDocs":{"description":"Clickstream Country Search Volume Distribution documentation","url":"https://www.nexscope.ai/api-docs/seo-search-volume-country-distribution"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keywords":{"type":"array","items":{"type":"string","minLength":1,"description":"After Unicode trim, 3 to 80 ASCII letters, digits, ordinary spaces, apostrophes or hyphens; at least one letter or digit; at most ten words."},"minItems":1,"maxItems":20}},"required":["keywords"],"additionalProperties":false},"example":{"keywords":[" Shoes ","shoes"]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"inputKeywords":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":20},"normalizedKeywords":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":20},"sourceProduct":{"type":"string","const":"keywords_data"},"sourceKind":{"type":"string","const":"clickstream_country_distribution"},"marketScope":{"type":"string","const":"GLOBAL"},"languageFilter":{"type":"null"},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"globalAverageMonthlySearches":{"type":["integer","null"],"minimum":0},"countries":{"type":"array","items":{"type":"object","properties":{"countryCode":{"type":"string","pattern":"^[A-Z]{2}$"},"averageMonthlySearches":{"type":["integer","null"],"minimum":0},"globalPercentage":{"type":["number","null"],"minimum":0,"maximum":100},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["countryCode","averageMonthlySearches","globalPercentage","missing"],"additionalProperties":false},"minItems":0,"maxItems":300},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["keyword","globalAverageMonthlySearches","countries","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["inputKeywords","normalizedKeywords","sourceProduct","sourceKind","marketScope","languageFilter","returnedCount","truncated","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-search-volume-country-distribution","x-nexscope-mcp-tool-name":"nexscope_seo_search_volume_country_distribution","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-keyword-interest-history/run":{"post":{"tags":["Keywords & Trends"],"summary":"Keyword Interest History","description":"Nexscope Trends relative interest history for the United States. Scores describe relative interest; zero means insufficient data. Preserve provider dates and do not interpolate search volumes.","operationId":"runSeoKeywordInterestHistory","externalDocs":{"description":"Keyword Interest History documentation","url":"https://www.nexscope.ai/api-docs/seo-keyword-interest-history"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keywords":{"type":"array","items":{"type":"string","minLength":1,"description":"After Unicode trim, NFC and lowercase, 1 to 80 code points and at most ten whitespace-separated words; no control characters."},"minItems":1,"maxItems":5},"market":{"type":"string","const":"US","default":"US"},"dateFrom":{"type":"string","format":"date","description":"2004-01-01 or later; inclusive interval at most 366 days."},"dateTo":{"type":"string","format":"date","description":"No later than first acceptance UTC day; replay retains the frozen dates."}},"required":["keywords","dateFrom","dateTo"],"additionalProperties":false},"example":{"dateTo":"2024-01-02","dateFrom":"2024-01-01","keywords":[" Shoes ","boots"]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"inputKeywords":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":5},"normalizedKeywords":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":5},"sourceProduct":{"type":"string","const":"keywords_data"},"sourceKind":{"type":"string","const":"dataforseo_trends_relative"},"marketScope":{"type":"string","const":"US"},"languageFilter":{"type":"null"},"dateFrom":{"type":"string","format":"date"},"dateTo":{"type":"string","format":"date"},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"averageInterest":{"type":["integer","null"],"minimum":0,"maximum":100},"points":{"type":"array","items":{"type":"object","properties":{"dateFrom":{"type":"string","format":"date"},"dateTo":{"type":"string","format":"date"},"observedAt":{"type":["integer","null"],"minimum":0},"interest":{"type":["integer","null"],"minimum":0,"maximum":100},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["dateFrom","dateTo","observedAt","interest","missing"],"additionalProperties":false},"minItems":0,"maxItems":366},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["keyword","averageInterest","points","missing"],"additionalProperties":false},"minItems":0,"maxItems":5},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"zeroMeaning":{"type":"string","const":"insufficient_data"}},"required":["inputKeywords","normalizedKeywords","sourceProduct","sourceKind","marketScope","languageFilter","dateFrom","dateTo","returnedCount","truncated","items","missing","zeroMeaning"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-keyword-interest-history","x-nexscope-mcp-tool-name":"nexscope_seo_keyword_interest_history","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-keyword-interest-regions/run":{"post":{"tags":["Keywords & Trends"],"summary":"Keyword Interest by Region","description":"Nexscope Trends relative keyword interest across United States regions. Regional scores are relative indices, not country percentages or absolute search counts. Preserve provider region IDs.","operationId":"runSeoKeywordInterestRegions","externalDocs":{"description":"Keyword Interest by Region documentation","url":"https://www.nexscope.ai/api-docs/seo-keyword-interest-regions"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keywords":{"type":"array","items":{"type":"string","minLength":1,"description":"After Unicode trim, NFC and lowercase, 1 to 80 code points and at most ten whitespace-separated words; no control characters."},"minItems":1,"maxItems":5},"market":{"type":"string","const":"US","default":"US"},"dateFrom":{"type":"string","format":"date","description":"2004-01-01 or later; inclusive interval at most 366 days."},"dateTo":{"type":"string","format":"date","description":"No later than first acceptance UTC day; replay retains the frozen dates."}},"required":["keywords","dateFrom","dateTo"],"additionalProperties":false},"example":{"dateTo":"2024-01-02","dateFrom":"2024-01-01","keywords":[" Shoes ","boots"]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"inputKeywords":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":5},"normalizedKeywords":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":5},"sourceProduct":{"type":"string","const":"keywords_data"},"sourceKind":{"type":"string","const":"dataforseo_trends_region_relative"},"marketScope":{"type":"string","const":"US"},"languageFilter":{"type":"null"},"dateFrom":{"type":"string","format":"date"},"dateTo":{"type":"string","format":"date"},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"regions":{"type":"array","items":{"type":"object","properties":{"geoId":{"type":["string","null"]},"geoName":{"type":["string","null"]},"interest":{"type":["integer","null"],"minimum":0,"maximum":100},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["geoId","geoName","interest","missing"],"additionalProperties":false},"minItems":0,"maxItems":300},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["keyword","regions","missing"],"additionalProperties":false},"minItems":0,"maxItems":5},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["inputKeywords","normalizedKeywords","sourceProduct","sourceKind","marketScope","languageFilter","dateFrom","dateTo","returnedCount","truncated","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-keyword-interest-regions","x-nexscope-mcp-tool-name":"nexscope_seo_keyword_interest_regions","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-keyword-interest-demographics/run":{"post":{"tags":["Keywords & Trends"],"summary":"Keyword Interest by Demographic","description":"Nexscope Trends relative keyword interest by age and gender. Each dimension has relative peak-normalized scores. Do not infer population shares, counts, income, or unreturned demographic buckets.","operationId":"runSeoKeywordInterestDemographics","externalDocs":{"description":"Keyword Interest by Demographic documentation","url":"https://www.nexscope.ai/api-docs/seo-keyword-interest-demographics"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keywords":{"type":"array","items":{"type":"string","minLength":1,"description":"After Unicode trim, NFC and lowercase, 1 to 80 code points and at most ten whitespace-separated words; no control characters."},"minItems":1,"maxItems":5},"market":{"type":"string","const":"US","default":"US"},"dateFrom":{"type":"string","format":"date","description":"2004-01-01 or later; inclusive interval at most 366 days."},"dateTo":{"type":"string","format":"date","description":"No later than first acceptance UTC day; replay retains the frozen dates."}},"required":["keywords","dateFrom","dateTo"],"additionalProperties":false},"example":{"dateTo":"2024-01-02","dateFrom":"2024-01-01","keywords":[" Shoes ","boots"]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"inputKeywords":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":5},"normalizedKeywords":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":5},"sourceProduct":{"type":"string","const":"keywords_data"},"sourceKind":{"type":"string","const":"dataforseo_trends_demographic_relative"},"marketScope":{"type":"string","const":"US"},"languageFilter":{"type":"null"},"dateFrom":{"type":"string","format":"date"},"dateTo":{"type":"string","format":"date"},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"age":{"type":"array","items":{"type":"object","properties":{"band":{"type":"string","enum":["18-24","25-34","35-44","45-54","55-64"]},"interest":{"type":["integer","null"],"minimum":0,"maximum":100},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["band","interest","missing"],"additionalProperties":false},"minItems":0,"maxItems":5},"gender":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string","enum":["female","male"]},"interest":{"type":["integer","null"],"minimum":0,"maximum":100},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["category","interest","missing"],"additionalProperties":false},"minItems":0,"maxItems":2},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["keyword","age","gender","missing"],"additionalProperties":false},"minItems":0,"maxItems":5},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["inputKeywords","normalizedKeywords","sourceProduct","sourceKind","marketScope","languageFilter","dateFrom","dateTo","returnedCount","truncated","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-keyword-interest-demographics","x-nexscope-mcp-tool-name":"nexscope_seo_keyword_interest_demographics","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-search-autocomplete/run":{"post":{"tags":["Keywords & Trends"],"summary":"Google Search Autocomplete","description":"A Google US English autocomplete sample for one keyword. Preserve suggestions from the fixed client. Missing optional fields stay null; no complete search coverage is implied.","operationId":"runSeoSearchAutocomplete","externalDocs":{"description":"Google Search Autocomplete documentation","url":"https://www.nexscope.ai/api-docs/seo-search-autocomplete"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"Trim, NFC and lowercase, 1 to 80 Unicode code points, at most ten words; no controls or colons."},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["keyword"],"additionalProperties":false},"example":{"keyword":" C++ ","limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"inputKeyword":{"type":"string"},"keyword":{"type":"string"},"sourceProduct":{"type":"string","const":"serp"},"sourceKind":{"type":"string","const":"google_autocomplete_sample"},"marketScope":{"type":"string","const":"US"},"languageFilter":{"type":"string","const":"en"},"requestedLimit":{"type":"integer","minimum":1},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"sample":{"type":["object","null"],"properties":{"observedAt":{"type":["integer","null"],"minimum":0},"checkUrl":{"type":["string","null"]},"observedTypes":{"type":"array","items":{"type":"string"}}},"required":["observedAt","checkUrl","observedTypes"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"suggestion":{"type":"string"},"suggestionType":{"type":["string","null"]},"rankGroup":{"type":["integer","null"],"minimum":1},"rankAbsolute":{"type":["integer","null"],"minimum":1},"searchUrl":{"type":["string","null"]},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["suggestion","suggestionType","rankGroup","rankAbsolute","searchUrl","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["inputKeyword","keyword","sourceProduct","sourceKind","marketScope","languageFilter","requestedLimit","returnedCount","truncated","sample","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-search-autocomplete","x-nexscope-mcp-tool-name":"nexscope_seo_search_autocomplete","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-historical-serps/run":{"post":{"tags":["Search Results & Rankings"],"summary":"Historical Organic SERP Snapshots","description":"Historical Organic SERP Snapshots. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoHistoricalSerps","externalDocs":{"description":"Historical Organic SERP Snapshots documentation","url":"https://www.nexscope.ai/api-docs/seo-historical-serps"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"maxLength":80},"dateFrom":{"type":"string","format":"date"},"dateTo":{"type":"string","format":"date"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"}},"required":["keyword","dateFrom","dateTo"],"additionalProperties":false},"example":{"limit":2,"dateTo":"2026-01-02","keyword":"C++","dateFrom":"2026-01-01"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"keyword":{"type":"string"},"normalizedKeyword":{"type":"string"},"dateFrom":{"type":"string"},"dateTo":{"type":"string"},"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"dataforseo_labs"},"engine":{"type":"string","const":"google"},"returnedCount":{"type":"integer","minimum":0},"sourceKind":{"type":"string","const":"historical_serp_database"},"projection":{"type":"string","const":"organic"},"requestedResultsPerSnapshot":{"type":"integer","minimum":1,"maximum":20},"items":{"type":"array","items":{"type":"object","properties":{"observedAt":{"type":"integer","minimum":0},"checkUrl":{"type":["string","null"]},"correctedKeyword":{"type":["string","null"]},"correctionType":{"type":["string","null"],"enum":["did_you_mean","showing_results_for","no_results_found_for",null]},"observedSerpTypes":{"type":"array","items":{"type":"string"},"minItems":0,"maxItems":10000},"organicResults":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"organic"},"url":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"rankGroup":{"type":["integer","null"],"minimum":1},"rankAbsolute":{"type":["integer","null"],"minimum":1},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["type","url","title","description","rankGroup","rankAbsolute","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["observedAt","checkUrl","correctedKeyword","correctionType","observedSerpTypes","organicResults","missing"],"additionalProperties":false},"minItems":0,"maxItems":31},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"}},"required":["keyword","normalizedKeyword","dateFrom","dateTo","market","language","sourceProduct","engine","returnedCount","sourceKind","projection","requestedResultsPerSnapshot","items","missing","truncated"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-historical-serps","x-nexscope-mcp-tool-name":"nexscope_seo_historical_serps","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-google-maps-results/run":{"post":{"tags":["Search Results & Rankings"],"summary":"Google Maps Search Results","description":"A Google Maps US English sample of non-advertising map results. Preserve place identifiers, string CIDs, coordinates, and rating scales. Paid map items are outside this projection.","operationId":"runSeoGoogleMapsResults","externalDocs":{"description":"Google Maps Search Results documentation","url":"https://www.nexscope.ai/api-docs/seo-google-maps-results"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"Trim, NFC and lowercase, 1 to 80 Unicode code points, at most ten words; no controls or colons."},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["keyword"],"additionalProperties":false},"example":{"keyword":" Shoes ","limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"inputKeyword":{"type":"string"},"keyword":{"type":"string"},"sourceProduct":{"type":"string","const":"serp"},"sourceKind":{"type":"string","const":"google_maps_sample"},"marketScope":{"type":"string","const":"US"},"languageFilter":{"type":"string","const":"en"},"requestedLimit":{"type":"integer","minimum":1},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"sample":{"type":["object","null"],"properties":{"observedAt":{"type":["integer","null"],"minimum":0},"checkUrl":{"type":["string","null"]},"observedTypes":{"type":"array","items":{"type":"string"}}},"required":["observedAt","checkUrl","observedTypes"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"placeId":{"type":["string","null"]},"cid":{"type":["string","null"]},"url":{"type":["string","null"]},"address":{"type":["string","null"]},"category":{"type":["string","null"]},"latitude":{"type":["number","null"],"minimum":-90,"maximum":90},"longitude":{"type":["number","null"],"minimum":-180,"maximum":180},"rankGroup":{"type":["integer","null"],"minimum":1},"rankAbsolute":{"type":["integer","null"],"minimum":1},"rating":{"type":"object","properties":{"type":{"type":["string","null"]},"value":{"type":["number","null"],"minimum":0},"maximum":{"type":["number","null"],"minimum":0},"votes":{"type":["integer","null"],"minimum":0}},"required":["type","value","maximum","votes"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["title","placeId","cid","url","address","category","latitude","longitude","rankGroup","rankAbsolute","rating","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["inputKeyword","keyword","sourceProduct","sourceKind","marketScope","languageFilter","requestedLimit","returnedCount","truncated","sample","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-google-maps-results","x-nexscope-mcp-tool-name":"nexscope_seo_google_maps_results","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-google-local-finder-results/run":{"post":{"tags":["Search Results & Rankings"],"summary":"Google Local Finder Results","description":"A Google Local Finder US English sample of local listings. Preserve paid status and booking links. Do not infer addresses or coordinates from descriptions.","operationId":"runSeoGoogleLocalFinderResults","externalDocs":{"description":"Google Local Finder Results documentation","url":"https://www.nexscope.ai/api-docs/seo-google-local-finder-results"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"Trim, NFC and lowercase, 1 to 80 Unicode code points, at most ten words; no controls or colons."},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["keyword"],"additionalProperties":false},"example":{"keyword":" Shoes ","limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"inputKeyword":{"type":"string"},"keyword":{"type":"string"},"sourceProduct":{"type":"string","const":"serp"},"sourceKind":{"type":"string","const":"google_local_finder_sample"},"marketScope":{"type":"string","const":"US"},"languageFilter":{"type":"string","const":"en"},"requestedLimit":{"type":"integer","minimum":1},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"sample":{"type":["object","null"],"properties":{"observedAt":{"type":["integer","null"],"minimum":0},"checkUrl":{"type":["string","null"]},"observedTypes":{"type":"array","items":{"type":"string"}}},"required":["observedAt","checkUrl","observedTypes"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"cid":{"type":["string","null"]},"url":{"type":["string","null"]},"description":{"type":["string","null"]},"phone":{"type":["string","null"]},"bookingUrl":{"type":["string","null"]},"isPaid":{"type":["boolean","null"]},"rating":{"type":"object","properties":{"type":{"type":["string","null"]},"value":{"type":["number","null"],"minimum":0},"maximum":{"type":["number","null"],"minimum":0},"votes":{"type":["integer","null"],"minimum":0}},"required":["type","value","maximum","votes"],"additionalProperties":false},"rankGroup":{"type":["integer","null"],"minimum":1},"rankAbsolute":{"type":["integer","null"],"minimum":1},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["title","cid","url","description","phone","bookingUrl","isPaid","rating","rankGroup","rankAbsolute","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["inputKeyword","keyword","sourceProduct","sourceKind","marketScope","languageFilter","requestedLimit","returnedCount","truncated","sample","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-google-local-finder-results","x-nexscope-mcp-tool-name":"nexscope_seo_google_local_finder_results","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-google-news-results/run":{"post":{"tags":["Search Results & Rankings"],"summary":"Google News Search Results","description":"A Google US English news_search sample with publication evidence. Top stories remain observed sample types without expansion. Relative publication labels do not replace timestamps.","operationId":"runSeoGoogleNewsResults","externalDocs":{"description":"Google News Search Results documentation","url":"https://www.nexscope.ai/api-docs/seo-google-news-results"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"Trim, NFC and lowercase, 1 to 80 Unicode code points, at most ten words; no controls or colons."},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"limit":{"type":"integer","minimum":1,"maximum":10,"default":10}},"required":["keyword"],"additionalProperties":false},"example":{"keyword":" Shoes ","limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"inputKeyword":{"type":"string"},"keyword":{"type":"string"},"sourceProduct":{"type":"string","const":"serp"},"sourceKind":{"type":"string","const":"google_news_sample"},"marketScope":{"type":"string","const":"US"},"languageFilter":{"type":"string","const":"en"},"requestedLimit":{"type":"integer","minimum":1},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"sample":{"type":["object","null"],"properties":{"observedAt":{"type":["integer","null"],"minimum":0},"checkUrl":{"type":["string","null"]},"observedTypes":{"type":"array","items":{"type":"string"}}},"required":["observedAt","checkUrl","observedTypes"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":["string","null"]},"snippet":{"type":["string","null"]},"imageUrl":{"type":["string","null"]},"publishedAt":{"type":["integer","null"],"minimum":0},"publishedLabel":{"type":["string","null"]},"rankGroup":{"type":["integer","null"],"minimum":1},"rankAbsolute":{"type":["integer","null"],"minimum":1},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["url","title","snippet","imageUrl","publishedAt","publishedLabel","rankGroup","rankAbsolute","missing"],"additionalProperties":false},"minItems":0,"maxItems":10},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"projection":{"type":"string","const":"news_search"}},"required":["inputKeyword","keyword","sourceProduct","sourceKind","marketScope","languageFilter","requestedLimit","returnedCount","truncated","sample","items","missing","projection"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-google-news-results","x-nexscope-mcp-tool-name":"nexscope_seo_google_news_results","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-google-image-results/run":{"post":{"tags":["Search Results & Rankings"],"summary":"Google Image Search Results","description":"A Google US English image_search sample with page and image references. Keep page, original image, and cached image URLs distinct. References do not imply image ownership or authorize downloads.","operationId":"runSeoGoogleImageResults","externalDocs":{"description":"Google Image Search Results documentation","url":"https://www.nexscope.ai/api-docs/seo-google-image-results"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"Trim, NFC and lowercase, 1 to 80 Unicode code points, at most ten words; no controls or colons."},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["keyword"],"additionalProperties":false},"example":{"keyword":" Shoes ","limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"inputKeyword":{"type":"string"},"keyword":{"type":"string"},"sourceProduct":{"type":"string","const":"serp"},"sourceKind":{"type":"string","const":"google_images_sample"},"marketScope":{"type":"string","const":"US"},"languageFilter":{"type":"string","const":"en"},"requestedLimit":{"type":"integer","minimum":1},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"sample":{"type":["object","null"],"properties":{"observedAt":{"type":["integer","null"],"minimum":0},"checkUrl":{"type":["string","null"]},"observedTypes":{"type":"array","items":{"type":"string"}}},"required":["observedAt","checkUrl","observedTypes"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"pageUrl":{"type":"string"},"imageUrl":{"type":["string","null"]},"cachedImageUrl":{"type":["string","null"]},"title":{"type":["string","null"]},"alt":{"type":["string","null"]},"rankGroup":{"type":["integer","null"],"minimum":1},"rankAbsolute":{"type":["integer","null"],"minimum":1},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["pageUrl","imageUrl","cachedImageUrl","title","alt","rankGroup","rankAbsolute","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["inputKeyword","keyword","sourceProduct","sourceKind","marketScope","languageFilter","requestedLimit","returnedCount","truncated","sample","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-google-image-results","x-nexscope-mcp-tool-name":"nexscope_seo_google_image_results","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-reverse-image-results/run":{"post":{"tags":["Search Results & Rankings"],"summary":"Reverse Image Search Results","description":"Reverse Image Search Results. Bounded Google reverse-image search observations with explicit missing evidence. One submit and at most eight fixed reads. Missing values are not zero. Prices and publication are unapproved.  Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoReverseImageResults","externalDocs":{"description":"Reverse Image Search Results documentation","url":"https://www.nexscope.ai/api-docs/seo-reverse-image-results"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imageUrl":{"type":"string","maxLength":2048,"description":"Public ASCII HTTPS URL without query, fragment, credentials, IP literal or non-default port"},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["imageUrl"],"additionalProperties":false},"example":{"imageUrl":"https://example.com/"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"sourceProduct":{"type":"string","const":"serp"},"sourceKind":{"type":"string","const":"google_reverse_image_sample"},"marketScope":{"type":"string","const":"US"},"languageFilter":{"type":"string","const":"en"},"inputImageUrl":{"type":"string"},"imageUrl":{"type":"string"},"requestedLimit":{"type":"integer","minimum":1,"maximum":20},"returnedCount":{"type":"integer","minimum":0,"maximum":20},"truncated":{"type":"boolean"},"associatedKeyword":{"type":["string","null"]},"sample":{"anyOf":[{"type":"null"},{"type":"object","properties":{"observedAt":{"type":["integer","null"],"minimum":0},"checkUrl":{"type":["string","null"]},"observedTypes":{"type":"array","items":{"type":"string"}}},"required":["observedAt","checkUrl","observedTypes"],"additionalProperties":false}]},"items":{"type":"array","maxItems":20,"items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"PAGE"},"url":{"type":"string"},"title":{"type":["string","null"]},"rankGroup":{"type":["integer","null"],"minimum":1,"maximum":9007199254740991},"rankAbsolute":{"type":["integer","null"],"minimum":1,"maximum":9007199254740991},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false}}},"required":["kind","url","title","rankGroup","rankAbsolute","missing"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"IMAGE"},"pageUrl":{"type":"string"},"imageUrl":{"type":["string","null"]},"alt":{"type":["string","null"]},"parentRankGroup":{"type":["integer","null"],"minimum":1,"maximum":9007199254740991},"parentRankAbsolute":{"type":["integer","null"],"minimum":1,"maximum":9007199254740991},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false}}},"required":["kind","pageUrl","imageUrl","alt","parentRankGroup","parentRankAbsolute","missing"],"additionalProperties":false}]}},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false}}},"required":["sourceProduct","sourceKind","marketScope","languageFilter","inputImageUrl","imageUrl","requestedLimit","returnedCount","truncated","associatedKeyword","sample","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-reverse-image-results","x-nexscope-mcp-tool-name":"nexscope_seo_reverse_image_results","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-shopping-products/run":{"post":{"tags":["Search Results & Rankings"],"summary":"Shopping Products","description":"A bounded Google Shopping product search with observed product references and explicit missing evidence. One submit and at most eight fixed reads. Missing values are not zero. Prices and publication are unapproved.  Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoShoppingProducts","externalDocs":{"description":"Shopping Products documentation","url":"https://www.nexscope.ai/api-docs/seo-shopping-products"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"maxLength":200},"limit":{"type":"integer","minimum":1,"maximum":40,"default":20}},"required":["keyword"],"additionalProperties":false},"example":{"keyword":"Reusable packaging"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"meta":{"type":"object","properties":{"source":{"type":"string","const":"DATAFORSEO_GOOGLE_SHOPPING_PRODUCTS"},"sampledAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"retrievedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"market":{"type":"object","properties":{"country":{"type":"string","const":"US"},"locationCode":{"type":"integer","const":2840},"language":{"type":"string","const":"en"}},"required":["country","locationCode","language"],"additionalProperties":false},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","maxLength":256},"reason":{"type":"string","enum":["MISSING","NULL","INVALID","UNSUPPORTED","TRUNCATED"]}},"required":["path","reason"],"additionalProperties":false},"maxItems":100},"missingOverflow":{"type":"boolean"}},"required":["source","sampledAt","retrievedAt","market","truncated","missing","missingOverflow"],"additionalProperties":false},"keyword":{"type":"string","maxLength":200},"products":{"type":"array","items":{"type":"object","properties":{"productRef":{"type":"string","pattern":"^[0-9a-f]{64}$"},"title":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]},"description":{"anyOf":[{"type":"string","maxLength":8192},{"type":"null"}]},"shoppingUrl":{"anyOf":[{"type":"string","maxLength":4096},{"type":"null"}]},"price":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"oldPrice":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"anyOf":[{"type":"string","pattern":"^[A-Z]{3}$"},{"type":"null"}]},"installmentMonths":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"seller":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]},"domain":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]},"rankGroup":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"rankAbsolute":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"detailEligible":{"type":"boolean"}},"required":["productRef","title","description","shoppingUrl","price","oldPrice","currency","installmentMonths","seller","domain","rankGroup","rankAbsolute","detailEligible"],"additionalProperties":false},"maxItems":40}},"required":["meta","keyword","products"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-shopping-products","x-nexscope-mcp-tool-name":"nexscope_seo_shopping_products","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-shopping-product-details/run":{"post":{"tags":["Search Results & Rankings"],"summary":"Shopping Product Details","description":"Source-bound Google Shopping product details with observed specifications and explicit missing evidence. One submit and at most eight fixed reads. Missing values are not zero. Prices and publication are unapproved.  Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoShoppingProductDetails","externalDocs":{"description":"Shopping Product Details documentation","url":"https://www.nexscope.ai/api-docs/seo-shopping-product-details"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid"},"productRef":{"type":"string","pattern":"^[0-9a-f]{64}$"}},"required":["task_id","productRef"],"additionalProperties":false},"example":{"task_id":"22222222-2222-4222-8222-222222222222","productRef":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"meta":{"type":"object","properties":{"source":{"type":"string","const":"DATAFORSEO_GOOGLE_SHOPPING_PRODUCT_INFO"},"sampledAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"retrievedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"market":{"type":"object","properties":{"country":{"type":"string","const":"US"},"locationCode":{"type":"integer","const":2840},"language":{"type":"string","const":"en"}},"required":["country","locationCode","language"],"additionalProperties":false},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","maxLength":256},"reason":{"type":"string","enum":["MISSING","NULL","INVALID","UNSUPPORTED","TRUNCATED"]}},"required":["path","reason"],"additionalProperties":false},"maxItems":100},"missingOverflow":{"type":"boolean"}},"required":["source","sampledAt","retrievedAt","market","truncated","missing","missingOverflow"],"additionalProperties":false},"sourceCallId":{"type":"string","format":"uuid"},"productRef":{"type":"string","pattern":"^[0-9a-f]{64}$"},"details":{"type":"array","items":{"type":"object","properties":{"title":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]},"description":{"anyOf":[{"type":"string","maxLength":8192},{"type":"null"}]},"url":{"anyOf":[{"type":"string","maxLength":4096},{"type":"null"}]},"images":{"type":"array","items":{"type":"string","maxLength":4096},"maxItems":20},"features":{"type":"array","items":{"type":"string","maxLength":1024},"maxItems":30},"specifications":{"type":"array","items":{"type":"object","properties":{"blockName":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]},"name":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]},"value":{"anyOf":[{"type":"string","maxLength":8192},{"type":"null"}]}},"required":["blockName","name","value"],"additionalProperties":false},"maxItems":50}},"required":["title","description","url","images","features","specifications"],"additionalProperties":false},"maxItems":10}},"required":["meta","sourceCallId","productRef","details"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-shopping-product-details","x-nexscope-mcp-tool-name":"nexscope_seo_shopping_product_details","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-shopping-seller-offers/run":{"post":{"tags":["Search Results & Rankings"],"summary":"Shopping Seller Offers","description":"Source-bound Google Shopping seller offers with observed prices and explicit missing evidence. One submit and at most eight fixed reads. Missing values are not zero. Prices and publication are unapproved.  Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoShoppingSellerOffers","externalDocs":{"description":"Shopping Seller Offers documentation","url":"https://www.nexscope.ai/api-docs/seo-shopping-seller-offers"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","format":"uuid"},"productRef":{"type":"string","pattern":"^[0-9a-f]{64}$"},"limit":{"type":"integer","minimum":1,"maximum":10,"default":10}},"required":["task_id","productRef"],"additionalProperties":false},"example":{"task_id":"22222222-2222-4222-8222-222222222222","productRef":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"meta":{"type":"object","properties":{"source":{"type":"string","const":"DATAFORSEO_GOOGLE_SHOPPING_SELLERS"},"sampledAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"retrievedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"market":{"type":"object","properties":{"country":{"type":"string","const":"US"},"locationCode":{"type":"integer","const":2840},"language":{"type":"string","const":"en"}},"required":["country","locationCode","language"],"additionalProperties":false},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","maxLength":256},"reason":{"type":"string","enum":["MISSING","NULL","INVALID","UNSUPPORTED","TRUNCATED"]}},"required":["path","reason"],"additionalProperties":false},"maxItems":100},"missingOverflow":{"type":"boolean"}},"required":["source","sampledAt","retrievedAt","market","truncated","missing","missingOverflow"],"additionalProperties":false},"sourceCallId":{"type":"string","format":"uuid"},"productRef":{"type":"string","pattern":"^[0-9a-f]{64}$"},"offers":{"type":"array","items":{"type":"object","properties":{"sellerName":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]},"title":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]},"domain":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]},"url":{"anyOf":[{"type":"string","maxLength":4096},{"type":"null"}]},"details":{"anyOf":[{"type":"string","maxLength":8192},{"type":"null"}]},"basePrice":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"tax":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"shippingPrice":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"totalPrice":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"currency":{"anyOf":[{"type":"string","pattern":"^[A-Z]{3}$"},{"type":"null"}]},"installmentMonths":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"paymentBreakdown":{"anyOf":[{"type":"string","maxLength":8192},{"type":"null"}]},"rankGroup":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"rankAbsolute":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["sellerName","title","domain","url","details","basePrice","tax","shippingPrice","totalPrice","currency","installmentMonths","paymentBreakdown","rankGroup","rankAbsolute"],"additionalProperties":false},"maxItems":10}},"required":["meta","sourceCallId","productRef","offers"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-shopping-seller-offers","x-nexscope-mcp-tool-name":"nexscope_seo_shopping_seller_offers","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/serp-screenshot-evidence/run":{"post":{"tags":["Search Results & Rankings"],"summary":"Serp Screenshot Evidence","description":"Serp screenshot evidence with explicit observation scope and missing evidence. Uses a fixed bounded plan. Source and image facts retain their observation time; a screenshot does not prove current indexing or complete website coverage.","operationId":"runSerpScreenshotEvidence","externalDocs":{"description":"Serp Screenshot Evidence documentation","url":"https://www.nexscope.ai/api-docs/serp-screenshot-evidence"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","maxLength":64,"minLength":1}},"required":["task_id"],"additionalProperties":false},"example":{"task_id":"fixture-source"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"source":{"type":"object","properties":{"provider":{"type":"string","const":"DATAFORSEO"},"product":{"type":"string","const":"serp"},"candidateId":{"type":"string","const":"MD-SR-11"},"sourceCallId":{"type":["string","null"]},"sourceSchemaVersion":{"type":["string","null"]},"sourcePlanVersion":{"type":["string","null"]},"collectedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"queriedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"observationKind":{"type":"string","const":"SERP_HTML_RENDER"}},"required":["provider","product","candidateId","sourceCallId","sourceSchemaVersion","sourcePlanVersion","collectedAt","queriedAt","observationKind"],"additionalProperties":false},"coverage":{"type":"object","properties":{"sampled":{"type":"boolean","const":true},"maxCrawlPages":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"pagesCrawled":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"stopReason":{"type":["string","null"]},"providerTotal":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"returnedCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":0,"maximum":9007199254740991},"truncated":{"type":"boolean"},"invalidItemCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["sampled","maxCrawlPages","pagesCrawled","stopReason","providerTotal","returnedCount","offset","limit","truncated","invalidItemCount"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"sourceCallId":{"type":"string"},"engine":{"type":"string","const":"GOOGLE"},"searchType":{"type":"string","const":"ORGANIC"},"page":{"type":"integer","const":1},"device":{"type":"string","const":"DESKTOP"},"sourceObservedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"renderedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"image":{"type":["object","null"],"properties":{"artifactId":{"type":"string"},"mediaType":{"type":"string","enum":["image/png","image/jpeg"]},"byteLength":{"type":"integer","minimum":0,"maximum":9007199254740991},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"width":{"type":"integer","minimum":0,"maximum":9007199254740991},"height":{"type":"integer","minimum":0,"maximum":9007199254740991},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"downloadPath":{"type":"string"}},"required":["artifactId","mediaType","byteLength","sha256","width","height","expiresAt","downloadPath"],"additionalProperties":false}},"required":["sourceCallId","engine","searchType","page","device","sourceObservedAt","renderedAt","image"],"additionalProperties":false},"maxItems":1},"missingFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"}},"required":["field","reason"],"additionalProperties":false},"maxItems":10000},"warnings":{"type":"array","items":{"type":"string"},"maxItems":1000}},"required":["source","coverage","items","missingFields","warnings"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"serp-screenshot-evidence","x-nexscope-mcp-tool-name":"nexscope_serp_screenshot_evidence","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-serp-competitors/run":{"post":{"tags":["Competitors & Traffic"],"summary":"Organic Keyword Set Competitors","description":"Organic Keyword Set Competitors. Bounded Nexscope database facts with explicit missing evidence. One fixed task; no pagination. Missing values are not zero. Prices and publication are unapproved. Successful owner-only results remain available in call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoSerpCompetitors","externalDocs":{"description":"Organic Keyword Set Competitors documentation","url":"https://www.nexscope.ai/api-docs/seo-serp-competitors"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10},"keywords":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80},"minItems":1,"maxItems":20}},"required":["keywords"],"additionalProperties":false},"example":{"limit":2,"keywords":[" Shoes ","shoes","boots"]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"requestedLimit":{"type":"integer","minimum":1,"maximum":20},"returnedCount":{"type":"integer","minimum":0,"maximum":20},"seeds":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":20},"normalizedSeeds":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":20},"searchType":{"type":"string","const":"organic"},"ordering":{"type":"string","const":"rating_desc"},"trafficKind":{"type":"string","const":"estimated"},"items":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string","minLength":1},"averagePosition":{"type":["number","null"],"minimum":0},"medianPosition":{"type":["number","null"],"minimum":0},"rating":{"type":["number","null"],"minimum":0},"estimatedTraffic":{"type":["number","null"],"minimum":0},"keywordCount":{"type":["integer","null"],"minimum":0},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["domain","averagePosition","medianPosition","rating","estimatedTraffic","keywordCount","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["market","language","requestedLimit","returnedCount","seeds","normalizedSeeds","searchType","ordering","trafficKind","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-serp-competitors","x-nexscope-mcp-tool-name":"nexscope_seo_serp_competitors","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-domain-ranked-keywords/run":{"post":{"tags":["Competitors & Traffic"],"summary":"Domain Organic Ranked Keywords","description":"Domain Organic Ranked Keywords. Bounded Nexscope database facts with explicit missing evidence. One fixed task; no pagination. Missing values are not zero. Prices and publication are unapproved. Successful owner-only results remain available in call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoDomainRankedKeywords","externalDocs":{"description":"Domain Organic Ranked Keywords documentation","url":"https://www.nexscope.ai/api-docs/seo-domain-ranked-keywords"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10},"target":{"type":"string","minLength":1,"maxLength":254}},"required":["target"],"additionalProperties":false},"example":{"target":"example.com","limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"requestedLimit":{"type":"integer","minimum":1,"maximum":20},"returnedCount":{"type":"integer","minimum":0,"maximum":20},"inputTarget":{"type":"string"},"target":{"type":"string"},"searchType":{"type":"string","const":"organic"},"ordering":{"type":"string","const":"provider_default"},"items":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string","minLength":1},"searchVolume":{"type":["integer","null"],"minimum":0},"cpcUsd":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"url":{"type":["string","null"]},"rankGroup":{"type":["integer","null"],"minimum":1},"rankAbsolute":{"type":["integer","null"],"minimum":1},"serpType":{"const":"organic","type":"string"},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["keyword","searchVolume","cpcUsd","url","rankGroup","rankAbsolute","serpType","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["market","language","requestedLimit","returnedCount","inputTarget","target","searchType","ordering","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-domain-ranked-keywords","x-nexscope-mcp-tool-name":"nexscope_seo_domain_ranked_keywords","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-domain-competitors/run":{"post":{"tags":["Competitors & Traffic"],"summary":"Shared Organic Keyword Competitors","description":"Shared Organic Keyword Competitors. Bounded Nexscope database facts with explicit missing evidence. One fixed task; no pagination. Missing values are not zero. Prices and publication are unapproved. Successful owner-only results remain available in call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoDomainCompetitors","externalDocs":{"description":"Shared Organic Keyword Competitors documentation","url":"https://www.nexscope.ai/api-docs/seo-domain-competitors"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10},"target":{"type":"string","minLength":1,"maxLength":254}},"required":["target"],"additionalProperties":false},"example":{"target":"example.com","limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"requestedLimit":{"type":"integer","minimum":1,"maximum":20},"returnedCount":{"type":"integer","minimum":0,"maximum":20},"inputTarget":{"type":"string"},"target":{"type":"string"},"searchType":{"type":"string","const":"organic"},"maximumRankGroup":{"type":"integer","const":100},"ordering":{"type":"string","const":"target_intersection_organic_count_desc"},"items":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string","minLength":1},"averagePosition":{"type":["number","null"],"minimum":0},"sharedKeywordCount":{"type":["integer","null"],"minimum":0},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["domain","averagePosition","sharedKeywordCount","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["market","language","requestedLimit","returnedCount","inputTarget","target","searchType","maximumRankGroup","ordering","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-domain-competitors","x-nexscope-mcp-tool-name":"nexscope_seo_domain_competitors","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-domain-keyword-intersection/run":{"post":{"tags":["Competitors & Traffic"],"summary":"Domain Organic Keyword Intersection","description":"Domain Organic Keyword Intersection. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoDomainKeywordIntersection","externalDocs":{"description":"Domain Organic Keyword Intersection documentation","url":"https://www.nexscope.ai/api-docs/seo-domain-keyword-intersection"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target1":{"type":"string"},"target2":{"type":"string"},"mode":{"type":"string","enum":["INTERSECTION","FIRST_ONLY"],"default":"INTERSECTION"},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["target1","target2"],"additionalProperties":false},"example":{"limit":2,"mode":"FIRST_ONLY","target2":"other.com","target1":"example.com"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"inputTarget1":{"type":"string"},"inputTarget2":{"type":"string"},"target1":{"type":"string"},"target2":{"type":"string"},"mode":{"type":"string","enum":["INTERSECTION","FIRST_ONLY"]},"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"dataforseo_labs"},"engine":{"type":"string","const":"google"},"requestedLimit":{"type":"integer","minimum":1,"maximum":20},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"searchVolume":{"type":["integer","null"],"minimum":0},"first":{"type":"object","properties":{"type":{"type":"string","const":"organic"},"url":{"type":["string","null"]},"rankGroup":{"type":["integer","null"],"minimum":1},"rankAbsolute":{"type":["integer","null"],"minimum":1}},"required":["type","url","rankGroup","rankAbsolute"],"additionalProperties":false},"second":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"organic"},"url":{"type":["string","null"]},"rankGroup":{"type":["integer","null"],"minimum":1},"rankAbsolute":{"type":["integer","null"],"minimum":1}},"required":["type","url","rankGroup","rankAbsolute"],"additionalProperties":false},{"type":"null"}]},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["keyword","searchVolume","first","second","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"searchType":{"type":"string","const":"organic"},"ordering":{"type":"string","const":"search_volume_desc"}},"required":["inputTarget1","inputTarget2","target1","target2","mode","market","language","sourceProduct","engine","requestedLimit","returnedCount","items","missing","truncated","searchType","ordering"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-domain-keyword-intersection","x-nexscope-mcp-tool-name":"nexscope_seo_domain_keyword_intersection","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-subdomain-performance/run":{"post":{"tags":["Competitors & Traffic"],"summary":"Subdomain Organic Performance","description":"Subdomain Organic Performance. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoSubdomainPerformance","externalDocs":{"description":"Subdomain Organic Performance documentation","url":"https://www.nexscope.ai/api-docs/seo-subdomain-performance"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"target":{"type":"string","maxLength":254,"minLength":1},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["target"],"additionalProperties":false},"example":{"target":"example.com","limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"dataforseo_labs"},"engine":{"type":"string","const":"google"},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"subdomain":{"type":"string"},"organic":{"type":"object","properties":{"estimatedMonthlyVisits":{"type":["number","null"],"minimum":0},"serpCount":{"type":["integer","null"],"minimum":0},"estimatedEquivalentAdsCostUsd":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"positions":{"type":"object","properties":{"p1":{"type":["integer","null"],"minimum":0},"p2to3":{"type":["integer","null"],"minimum":0},"p4to10":{"type":["integer","null"],"minimum":0},"p11to20":{"type":["integer","null"],"minimum":0},"p21to30":{"type":["integer","null"],"minimum":0},"p31to40":{"type":["integer","null"],"minimum":0},"p41to50":{"type":["integer","null"],"minimum":0},"p51to60":{"type":["integer","null"],"minimum":0},"p61to70":{"type":["integer","null"],"minimum":0},"p71to80":{"type":["integer","null"],"minimum":0},"p81to90":{"type":["integer","null"],"minimum":0},"p91to100":{"type":["integer","null"],"minimum":0}},"required":["p1","p2to3","p4to10","p11to20","p21to30","p31to40","p41to50","p51to60","p61to70","p71to80","p81to90","p91to100"],"additionalProperties":false}},"required":["estimatedMonthlyVisits","serpCount","estimatedEquivalentAdsCostUsd","positions"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["subdomain","organic","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"requestedLimit":{"type":"integer","minimum":1,"maximum":20},"inputTarget":{"type":"string"},"target":{"type":"string"},"searchType":{"type":"string","const":"organic"},"trafficKind":{"type":"string","const":"estimated"},"ordering":{"type":"string","const":"organic_serp_count_desc"}},"required":["market","language","sourceProduct","engine","returnedCount","items","missing","truncated","requestedLimit","inputTarget","target","searchType","trafficKind","ordering"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-subdomain-performance","x-nexscope-mcp-tool-name":"nexscope_seo_subdomain_performance","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-top-pages/run":{"post":{"tags":["Competitors & Traffic"],"summary":"Top Organic Ranking Pages","description":"Top Organic Ranking Pages. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoTopPages","externalDocs":{"description":"Top Organic Ranking Pages documentation","url":"https://www.nexscope.ai/api-docs/seo-top-pages"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"target":{"type":"string","maxLength":254,"minLength":1},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["target"],"additionalProperties":false},"example":{"target":"example.com","limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"dataforseo_labs"},"engine":{"type":"string","const":"google"},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"organic":{"type":"object","properties":{"estimatedMonthlyVisits":{"type":["number","null"],"minimum":0},"serpCount":{"type":["integer","null"],"minimum":0},"estimatedEquivalentAdsCostUsd":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"positions":{"type":"object","properties":{"p1":{"type":["integer","null"],"minimum":0},"p2to3":{"type":["integer","null"],"minimum":0},"p4to10":{"type":["integer","null"],"minimum":0},"p11to20":{"type":["integer","null"],"minimum":0},"p21to30":{"type":["integer","null"],"minimum":0},"p31to40":{"type":["integer","null"],"minimum":0},"p41to50":{"type":["integer","null"],"minimum":0},"p51to60":{"type":["integer","null"],"minimum":0},"p61to70":{"type":["integer","null"],"minimum":0},"p71to80":{"type":["integer","null"],"minimum":0},"p81to90":{"type":["integer","null"],"minimum":0},"p91to100":{"type":["integer","null"],"minimum":0}},"required":["p1","p2to3","p4to10","p11to20","p21to30","p31to40","p41to50","p51to60","p61to70","p71to80","p81to90","p91to100"],"additionalProperties":false}},"required":["estimatedMonthlyVisits","serpCount","estimatedEquivalentAdsCostUsd","positions"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["url","organic","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"requestedLimit":{"type":"integer","minimum":1,"maximum":20},"inputTarget":{"type":"string"},"target":{"type":"string"},"searchType":{"type":"string","const":"organic"},"trafficKind":{"type":"string","const":"estimated"},"ordering":{"type":"string","const":"organic_estimated_traffic_desc"}},"required":["market","language","sourceProduct","engine","returnedCount","items","missing","truncated","requestedLimit","inputTarget","target","searchType","trafficKind","ordering"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-top-pages","x-nexscope-mcp-tool-name":"nexscope_seo_top_pages","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-domain-rank-overview/run":{"post":{"tags":["Competitors & Traffic"],"summary":"Domain Organic and Paid Rank Overview","description":"Domain Organic and Paid Rank Overview. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoDomainRankOverview","externalDocs":{"description":"Domain Organic and Paid Rank Overview documentation","url":"https://www.nexscope.ai/api-docs/seo-domain-rank-overview"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"target":{"type":"string","maxLength":254,"minLength":1}},"required":["target"],"additionalProperties":false},"example":{"target":"example.com"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"dataforseo_labs"},"engine":{"type":"string","const":"google"},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"organic":{"type":"object","properties":{"estimatedMonthlyVisits":{"type":["number","null"],"minimum":0},"serpCount":{"type":["integer","null"],"minimum":0},"estimatedEquivalentAdsCostUsd":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"positions":{"type":"object","properties":{"p1":{"type":["integer","null"],"minimum":0},"p2to3":{"type":["integer","null"],"minimum":0},"p4to10":{"type":["integer","null"],"minimum":0},"p11to20":{"type":["integer","null"],"minimum":0},"p21to30":{"type":["integer","null"],"minimum":0},"p31to40":{"type":["integer","null"],"minimum":0},"p41to50":{"type":["integer","null"],"minimum":0},"p51to60":{"type":["integer","null"],"minimum":0},"p61to70":{"type":["integer","null"],"minimum":0},"p71to80":{"type":["integer","null"],"minimum":0},"p81to90":{"type":["integer","null"],"minimum":0},"p91to100":{"type":["integer","null"],"minimum":0}},"required":["p1","p2to3","p4to10","p11to20","p21to30","p31to40","p41to50","p51to60","p61to70","p71to80","p81to90","p91to100"],"additionalProperties":false}},"required":["estimatedMonthlyVisits","serpCount","estimatedEquivalentAdsCostUsd","positions"],"additionalProperties":false},"paid":{"type":"object","properties":{"estimatedMonthlyVisits":{"type":["number","null"],"minimum":0},"serpCount":{"type":["integer","null"],"minimum":0},"estimatedEquivalentAdsCostUsd":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"positions":{"type":"object","properties":{"p1":{"type":["integer","null"],"minimum":0},"p2to3":{"type":["integer","null"],"minimum":0},"p4to10":{"type":["integer","null"],"minimum":0},"p11to20":{"type":["integer","null"],"minimum":0},"p21to30":{"type":["integer","null"],"minimum":0},"p31to40":{"type":["integer","null"],"minimum":0},"p41to50":{"type":["integer","null"],"minimum":0},"p51to60":{"type":["integer","null"],"minimum":0},"p61to70":{"type":["integer","null"],"minimum":0},"p71to80":{"type":["integer","null"],"minimum":0},"p81to90":{"type":["integer","null"],"minimum":0},"p91to100":{"type":["integer","null"],"minimum":0}},"required":["p1","p2to3","p4to10","p11to20","p21to30","p31to40","p41to50","p51to60","p61to70","p71to80","p81to90","p91to100"],"additionalProperties":false}},"required":["estimatedMonthlyVisits","serpCount","estimatedEquivalentAdsCostUsd","positions"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["organic","paid","missing"],"additionalProperties":false},"minItems":0,"maxItems":1},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"inputTarget":{"type":"string"},"target":{"type":"string"},"searchTypes":{"type":"array","items":{"type":"string"},"minItems":0,"maxItems":20},"trafficKind":{"type":"string","const":"estimated"},"snapshotKind":{"type":"string","const":"latest_database"}},"required":["market","language","sourceProduct","engine","returnedCount","items","missing","truncated","inputTarget","target","searchTypes","trafficKind","snapshotKind"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-domain-rank-overview","x-nexscope-mcp-tool-name":"nexscope_seo_domain_rank_overview","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-domain-rank-history/run":{"post":{"tags":["Competitors & Traffic"],"summary":"Domain Historical Ranking Distribution","description":"Domain Historical Ranking Distribution. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoDomainRankHistory","externalDocs":{"description":"Domain Historical Ranking Distribution documentation","url":"https://www.nexscope.ai/api-docs/seo-domain-rank-history"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"string"},"fromMonth":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"toMonth":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"}},"required":["target","fromMonth","toMonth"],"additionalProperties":false},"example":{"toMonth":"2026-03","target":"Example.COM.","fromMonth":"2026-01"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"inputTarget":{"type":"string"},"target":{"type":"string"},"fromMonth":{"type":"string"},"toMonth":{"type":"string"},"resolvedDateFrom":{"type":"string"},"resolvedDateTo":{"type":"string"},"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"dataforseo_labs"},"engine":{"type":"string","const":"google"},"returnedCount":{"type":"integer","minimum":0},"correlated":{"type":"boolean","const":true},"trafficKind":{"type":"string","const":"estimated"},"items":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"organic":{"type":"object","properties":{"estimatedMonthlyVisits":{"type":["number","null"],"minimum":0},"serpCount":{"type":["integer","null"],"minimum":0},"estimatedEquivalentAdsCostUsd":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"positions":{"type":"object","properties":{"p1":{"type":["integer","null"],"minimum":0},"p2to3":{"type":["integer","null"],"minimum":0},"p4to10":{"type":["integer","null"],"minimum":0},"p11to20":{"type":["integer","null"],"minimum":0},"p21to30":{"type":["integer","null"],"minimum":0},"p31to40":{"type":["integer","null"],"minimum":0},"p41to50":{"type":["integer","null"],"minimum":0},"p51to60":{"type":["integer","null"],"minimum":0},"p61to70":{"type":["integer","null"],"minimum":0},"p71to80":{"type":["integer","null"],"minimum":0},"p81to90":{"type":["integer","null"],"minimum":0},"p91to100":{"type":["integer","null"],"minimum":0}},"required":["p1","p2to3","p4to10","p11to20","p21to30","p31to40","p41to50","p51to60","p61to70","p71to80","p81to90","p91to100"],"additionalProperties":false}},"required":["estimatedMonthlyVisits","serpCount","estimatedEquivalentAdsCostUsd","positions"],"additionalProperties":false},"paid":{"type":"object","properties":{"estimatedMonthlyVisits":{"type":["number","null"],"minimum":0},"serpCount":{"type":["integer","null"],"minimum":0},"estimatedEquivalentAdsCostUsd":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"positions":{"type":"object","properties":{"p1":{"type":["integer","null"],"minimum":0},"p2to3":{"type":["integer","null"],"minimum":0},"p4to10":{"type":["integer","null"],"minimum":0},"p11to20":{"type":["integer","null"],"minimum":0},"p21to30":{"type":["integer","null"],"minimum":0},"p31to40":{"type":["integer","null"],"minimum":0},"p41to50":{"type":["integer","null"],"minimum":0},"p51to60":{"type":["integer","null"],"minimum":0},"p61to70":{"type":["integer","null"],"minimum":0},"p71to80":{"type":["integer","null"],"minimum":0},"p81to90":{"type":["integer","null"],"minimum":0},"p91to100":{"type":["integer","null"],"minimum":0}},"required":["p1","p2to3","p4to10","p11to20","p21to30","p31to40","p41to50","p51to60","p61to70","p71to80","p81to90","p91to100"],"additionalProperties":false}},"required":["estimatedMonthlyVisits","serpCount","estimatedEquivalentAdsCostUsd","positions"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["year","month","organic","paid","missing"],"additionalProperties":false},"minItems":0,"maxItems":12},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"}},"required":["inputTarget","target","fromMonth","toMonth","resolvedDateFrom","resolvedDateTo","market","language","sourceProduct","engine","returnedCount","correlated","trafficKind","items","missing","truncated"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-domain-rank-history","x-nexscope-mcp-tool-name":"nexscope_seo_domain_rank_history","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-page-keyword-intersection/run":{"post":{"tags":["Competitors & Traffic"],"summary":"Page Organic Keyword Intersection","description":"Page Organic Keyword Intersection. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoPageKeywordIntersection","externalDocs":{"description":"Page Organic Keyword Intersection documentation","url":"https://www.nexscope.ai/api-docs/seo-page-keyword-intersection"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"page1":{"type":"string"},"page2":{"type":"string"},"mode":{"type":"string","enum":["INTERSECTION","FIRST_ONLY"],"default":"INTERSECTION"},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["page1","page2"],"additionalProperties":false},"example":{"mode":"FIRST_ONLY","page2":"https://other.com/b","page1":"https://example.com/a","limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"inputPage1":{"type":"string"},"inputPage2":{"type":"string"},"page1":{"type":"string"},"page2":{"type":"string"},"mode":{"type":"string","enum":["INTERSECTION","FIRST_ONLY"]},"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"dataforseo_labs"},"engine":{"type":"string","const":"google"},"requestedLimit":{"type":"integer","minimum":1,"maximum":20},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"searchVolume":{"type":["integer","null"],"minimum":0},"first":{"type":"object","properties":{"type":{"type":"string","const":"organic"},"url":{"type":["string","null"]},"rankGroup":{"type":["integer","null"],"minimum":1},"rankAbsolute":{"type":["integer","null"],"minimum":1}},"required":["type","url","rankGroup","rankAbsolute"],"additionalProperties":false},"second":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"organic"},"url":{"type":["string","null"]},"rankGroup":{"type":["integer","null"],"minimum":1},"rankAbsolute":{"type":["integer","null"],"minimum":1}},"required":["type","url","rankGroup","rankAbsolute"],"additionalProperties":false},{"type":"null"}]},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["keyword","searchVolume","first","second","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"targetScope":{"type":"string","const":"exact_url"},"searchType":{"type":"string","const":"organic"}},"required":["inputPage1","inputPage2","page1","page2","mode","market","language","sourceProduct","engine","requestedLimit","returnedCount","items","missing","truncated","targetScope","searchType"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-page-keyword-intersection","x-nexscope-mcp-tool-name":"nexscope_seo_page_keyword_intersection","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-target-traffic-estimates/run":{"post":{"tags":["Competitors & Traffic"],"summary":"Multiple Target Organic and Paid Traffic Estimates","description":"Multiple Target Organic and Paid Traffic Estimates. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoTargetTrafficEstimates","externalDocs":{"description":"Multiple Target Organic and Paid Traffic Estimates documentation","url":"https://www.nexscope.ai/api-docs/seo-target-traffic-estimates"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"targets":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string"}},"required":["kind","target"],"additionalProperties":false},"minItems":1,"maxItems":20},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"}},"required":["targets"],"additionalProperties":false},"example":{"targets":[{"kind":"DOMAIN","target":"example.com"},{"kind":"PAGE","target":"https://example.com/a"}]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"inputTargets":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string"}},"required":["kind","target"],"additionalProperties":false},"minItems":1,"maxItems":20},"normalizedTargets":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string"}},"required":["kind","target"],"additionalProperties":false},"minItems":1,"maxItems":20},"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"dataforseo_labs"},"engine":{"type":"string","const":"google"},"returnedCount":{"type":"integer","minimum":0},"trafficKind":{"type":"string","const":"estimated"},"trafficMethod":{"type":"string","const":"ctr_times_search_volume"},"items":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string"},"organic":{"type":"object","properties":{"estimatedMonthlyVisits":{"type":["number","null"],"minimum":0},"serpCount":{"type":["integer","null"],"minimum":0}},"required":["estimatedMonthlyVisits","serpCount"],"additionalProperties":false},"paid":{"type":"object","properties":{"estimatedMonthlyVisits":{"type":["number","null"],"minimum":0},"serpCount":{"type":["integer","null"],"minimum":0}},"required":["estimatedMonthlyVisits","serpCount"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["kind","target","organic","paid","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"}},"required":["inputTargets","normalizedTargets","market","language","sourceProduct","engine","returnedCount","trafficKind","trafficMethod","items","missing","truncated"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-target-traffic-estimates","x-nexscope-mcp-tool-name":"nexscope_seo_target_traffic_estimates","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-domain-traffic-history/run":{"post":{"tags":["Competitors & Traffic"],"summary":"Historical Multi-Domain Traffic Comparison","description":"Historical Multi-Domain Traffic Comparison. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoDomainTrafficHistory","externalDocs":{"description":"Historical Multi-Domain Traffic Comparison documentation","url":"https://www.nexscope.ai/api-docs/seo-domain-traffic-history"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"targets":{"type":"array","items":{"type":"string"},"minItems":2,"maxItems":20},"fromMonth":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"toMonth":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"}},"required":["targets","fromMonth","toMonth"],"additionalProperties":false},"example":{"toMonth":"2026-03","targets":["example.com","other.com"],"fromMonth":"2026-01"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"inputTargets":{"type":"array","items":{"type":"string"},"minItems":2,"maxItems":20},"normalizedTargets":{"type":"array","items":{"type":"string"},"minItems":2,"maxItems":20},"fromMonth":{"type":"string"},"toMonth":{"type":"string"},"resolvedDateFrom":{"type":"string"},"resolvedDateTo":{"type":"string"},"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"dataforseo_labs"},"engine":{"type":"string","const":"google"},"returnedCount":{"type":"integer","minimum":0},"trafficKind":{"type":"string","const":"estimated"},"items":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"targets":{"type":"array","items":{"type":"object","properties":{"target":{"type":"string"},"organic":{"type":"object","properties":{"estimatedMonthlyVisits":{"type":["number","null"],"minimum":0},"serpCount":{"type":["integer","null"],"minimum":0}},"required":["estimatedMonthlyVisits","serpCount"],"additionalProperties":false},"paid":{"type":"object","properties":{"estimatedMonthlyVisits":{"type":["number","null"],"minimum":0},"serpCount":{"type":["integer","null"],"minimum":0}},"required":["estimatedMonthlyVisits","serpCount"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["target","organic","paid","missing"],"additionalProperties":false},"minItems":2,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["year","month","targets","missing"],"additionalProperties":false},"minItems":0,"maxItems":12},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"}},"required":["inputTargets","normalizedTargets","fromMonth","toMonth","resolvedDateFrom","resolvedDateTo","market","language","sourceProduct","engine","returnedCount","trafficKind","items","missing","truncated"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-domain-traffic-history","x-nexscope-mcp-tool-name":"nexscope_seo_domain_traffic_history","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-domain-categories/run":{"post":{"tags":["Competitors & Traffic"],"summary":"Ranked Keyword Domain Categories","description":"Ranked Keyword Domain Categories. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoDomainCategories","externalDocs":{"description":"Ranked Keyword Domain Categories documentation","url":"https://www.nexscope.ai/api-docs/seo-domain-categories"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"target":{"type":"string","maxLength":254,"minLength":1},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["target"],"additionalProperties":false},"example":{"target":"example.com","limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"dataforseo_labs"},"engine":{"type":"string","const":"google"},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"categoryIds":{"type":"array","items":{"type":"integer","minimum":1},"minItems":1,"maxItems":10000},"organic":{"type":"object","properties":{"estimatedMonthlyVisits":{"type":["number","null"],"minimum":0},"serpCount":{"type":["integer","null"],"minimum":0},"estimatedEquivalentAdsCostUsd":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"positions":{"type":"object","properties":{"p1":{"type":["integer","null"],"minimum":0},"p2to3":{"type":["integer","null"],"minimum":0},"p4to10":{"type":["integer","null"],"minimum":0},"p11to20":{"type":["integer","null"],"minimum":0},"p21to30":{"type":["integer","null"],"minimum":0},"p31to40":{"type":["integer","null"],"minimum":0},"p41to50":{"type":["integer","null"],"minimum":0},"p51to60":{"type":["integer","null"],"minimum":0},"p61to70":{"type":["integer","null"],"minimum":0},"p71to80":{"type":["integer","null"],"minimum":0},"p81to90":{"type":["integer","null"],"minimum":0},"p91to100":{"type":["integer","null"],"minimum":0}},"required":["p1","p2to3","p4to10","p11to20","p21to30","p31to40","p41to50","p51to60","p61to70","p71to80","p81to90","p91to100"],"additionalProperties":false}},"required":["estimatedMonthlyVisits","serpCount","estimatedEquivalentAdsCostUsd","positions"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["categoryIds","organic","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"requestedLimit":{"type":"integer","minimum":1,"maximum":20},"inputTarget":{"type":"string"},"target":{"type":"string"},"taxonomy":{"type":"string","const":"google_product_service"},"classificationBasis":{"type":"string","const":"ranked_keywords"},"includeSubcategories":{"type":"boolean","const":false},"searchType":{"type":"string","const":"organic"}},"required":["market","language","sourceProduct","engine","returnedCount","items","missing","truncated","requestedLimit","inputTarget","target","taxonomy","classificationBasis","includeSubcategories","searchType"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-domain-categories","x-nexscope-mcp-tool-name":"nexscope_seo_domain_categories","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-category-domain-comparison/run":{"post":{"tags":["Competitors & Traffic"],"summary":"Category Related Domain Monthly Comparison","description":"Category Related Domain Monthly Comparison. Bounded Google database facts; estimated traffic is not measured visits. One fixed Live POST, no pagination. Unknown fields and missing values are explicit. Execution and publication remain unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoCategoryDomainComparison","externalDocs":{"description":"Category Related Domain Monthly Comparison documentation","url":"https://www.nexscope.ai/api-docs/seo-category-domain-comparison"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"categoryIds":{"type":"array","items":{"type":"integer","minimum":1,"maximum":2147483647},"minItems":1,"maxItems":5},"firstMonth":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"secondMonth":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"}},"required":["categoryIds","firstMonth","secondMonth"],"additionalProperties":false},"example":{"secondMonth":"2026-01","limit":2,"categoryIds":[10001],"firstMonth":"2026-03"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"categoryIds":{"type":"array","items":{"type":"integer","minimum":1},"minItems":1,"maxItems":5},"normalizedCategoryIds":{"type":"array","items":{"type":"integer","minimum":1},"minItems":1,"maxItems":5},"firstMonth":{"type":"string"},"secondMonth":{"type":"string"},"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"dataforseo_labs"},"engine":{"type":"string","const":"google"},"requestedLimit":{"type":"integer","minimum":1,"maximum":20},"returnedCount":{"type":"integer","minimum":0},"taxonomy":{"type":"string","const":"google_product_service"},"trafficKind":{"type":"string","const":"estimated"},"comparisonDirection":{"type":"string","const":"second_minus_first"},"ordering":{"type":"string","const":"current_organic_etv_desc"},"items":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"mainDomain":{"type":["string","null"]},"categoryIds":{"type":"array","items":{"type":"integer","minimum":1},"minItems":0,"maxItems":10000},"currentEstimatedMonthlyVisits":{"type":["number","null"],"minimum":0},"currentSerpCount":{"type":["integer","null"],"minimum":0},"first":{"type":"object","properties":{"month":{"type":"string"},"organic":{"type":"object","properties":{"estimatedMonthlyVisits":{"type":["number","null"],"minimum":0},"serpCount":{"type":["integer","null"],"minimum":0},"estimatedEquivalentAdsCostUsd":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"positions":{"type":"object","properties":{"p1":{"type":["integer","null"],"minimum":0},"p2to3":{"type":["integer","null"],"minimum":0},"p4to10":{"type":["integer","null"],"minimum":0},"p11to20":{"type":["integer","null"],"minimum":0},"p21to30":{"type":["integer","null"],"minimum":0},"p31to40":{"type":["integer","null"],"minimum":0},"p41to50":{"type":["integer","null"],"minimum":0},"p51to60":{"type":["integer","null"],"minimum":0},"p61to70":{"type":["integer","null"],"minimum":0},"p71to80":{"type":["integer","null"],"minimum":0},"p81to90":{"type":["integer","null"],"minimum":0},"p91to100":{"type":["integer","null"],"minimum":0}},"required":["p1","p2to3","p4to10","p11to20","p21to30","p31to40","p41to50","p51to60","p61to70","p71to80","p81to90","p91to100"],"additionalProperties":false}},"required":["estimatedMonthlyVisits","serpCount","estimatedEquivalentAdsCostUsd","positions"],"additionalProperties":false}},"required":["month","organic"],"additionalProperties":false},"second":{"type":"object","properties":{"month":{"type":"string"},"organic":{"type":"object","properties":{"estimatedMonthlyVisits":{"type":["number","null"],"minimum":0},"serpCount":{"type":["integer","null"],"minimum":0},"estimatedEquivalentAdsCostUsd":{"type":["string","null"],"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"positions":{"type":"object","properties":{"p1":{"type":["integer","null"],"minimum":0},"p2to3":{"type":["integer","null"],"minimum":0},"p4to10":{"type":["integer","null"],"minimum":0},"p11to20":{"type":["integer","null"],"minimum":0},"p21to30":{"type":["integer","null"],"minimum":0},"p31to40":{"type":["integer","null"],"minimum":0},"p41to50":{"type":["integer","null"],"minimum":0},"p51to60":{"type":["integer","null"],"minimum":0},"p61to70":{"type":["integer","null"],"minimum":0},"p71to80":{"type":["integer","null"],"minimum":0},"p81to90":{"type":["integer","null"],"minimum":0},"p91to100":{"type":["integer","null"],"minimum":0}},"required":["p1","p2to3","p4to10","p11to20","p21to30","p31to40","p41to50","p51to60","p61to70","p71to80","p81to90","p91to100"],"additionalProperties":false}},"required":["estimatedMonthlyVisits","serpCount","estimatedEquivalentAdsCostUsd","positions"],"additionalProperties":false}},"required":["month","organic"],"additionalProperties":false},"change":{"type":"object","properties":{"estimatedMonthlyVisits":{"type":["number","null"]},"serpCount":{"type":["integer","null"]}},"required":["estimatedMonthlyVisits","serpCount"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["domain","mainDomain","categoryIds","currentEstimatedMonthlyVisits","currentSerpCount","first","second","change","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"}},"required":["categoryIds","normalizedCategoryIds","firstMonth","secondMonth","market","language","sourceProduct","engine","requestedLimit","returnedCount","taxonomy","trafficKind","comparisonDirection","ordering","items","missing","truncated"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-category-domain-comparison","x-nexscope-mcp-tool-name":"nexscope_seo_category_domain_comparison","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/website-audit-summary/run":{"post":{"tags":["Pages & Websites"],"summary":"Website Audit Summary","description":"Website audit summary with explicit observation scope and missing evidence. Uses a fixed bounded plan. Source and image facts retain their observation time; a screenshot does not prove current indexing or complete website coverage.","operationId":"runWebsiteAuditSummary","externalDocs":{"description":"Website Audit Summary documentation","url":"https://www.nexscope.ai/api-docs/website-audit-summary"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"string","maxLength":253},"profile":{"type":"string","enum":["BASE","ENRICHED"],"default":"BASE"}},"required":["target"],"additionalProperties":false},"example":{"target":"example.com"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"source":{"type":"object","properties":{"provider":{"type":"string","const":"DATAFORSEO"},"product":{"type":"string","const":"on_page"},"candidateId":{"type":"string","const":"MD-PW-02"},"sourceCallId":{"type":["string","null"]},"sourceSchemaVersion":{"type":["string","null"]},"sourcePlanVersion":{"type":["string","null"]},"collectedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"queriedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"observationKind":{"type":"string","const":"CRAWL_SAMPLE"}},"required":["provider","product","candidateId","sourceCallId","sourceSchemaVersion","sourcePlanVersion","collectedAt","queriedAt","observationKind"],"additionalProperties":false},"coverage":{"type":"object","properties":{"sampled":{"type":"boolean","const":true},"maxCrawlPages":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"pagesCrawled":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"stopReason":{"type":["string","null"]},"providerTotal":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"returnedCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":0,"maximum":9007199254740991},"truncated":{"type":"boolean"},"invalidItemCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["sampled","maxCrawlPages","pagesCrawled","stopReason","providerTotal","returnedCount","offset","limit","truncated","invalidItemCount"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"target":{"type":"string"},"profile":{"type":"string","enum":["BASE","ENRICHED"]},"pagesCrawled":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"stopReason":{"type":["string","null"]},"crawlStartedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"crawlEndedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"onpageScore":{"type":["number","null"],"minimum":0,"maximum":100},"internalLinks":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"externalLinks":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"duplicateTitles":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"duplicateDescriptions":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"duplicateContents":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"brokenLinks":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"brokenResources":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"nonIndexable":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991}},"required":["target","profile","pagesCrawled","stopReason","crawlStartedAt","crawlEndedAt","onpageScore","internalLinks","externalLinks","duplicateTitles","duplicateDescriptions","duplicateContents","brokenLinks","brokenResources","nonIndexable"],"additionalProperties":false},"maxItems":1},"missingFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"}},"required":["field","reason"],"additionalProperties":false},"maxItems":10000},"warnings":{"type":"array","items":{"type":"string"},"maxItems":1000}},"required":["source","coverage","items","missingFields","warnings"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"website-audit-summary","x-nexscope-mcp-tool-name":"nexscope_website_audit_summary","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/website-page-checks/run":{"post":{"tags":["Pages & Websites"],"summary":"Website Page Checks","description":"Website Page Checks from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.","operationId":"runWebsitePageChecks","externalDocs":{"description":"Website Page Checks documentation","url":"https://www.nexscope.ai/api-docs/website-page-checks"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","minLength":1,"maxLength":64},"limit":{"type":"integer","default":10,"minimum":1,"maximum":10}},"required":["task_id"],"additionalProperties":false},"example":{"task_id":"source-call"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"source":{"type":"object","properties":{"provider":{"type":"string","const":"DATAFORSEO"},"product":{"type":"string","const":"on_page"},"candidateId":{"type":"string","const":"MD-PW-03"},"sourceCallId":{"type":["string","null"]},"sourceSchemaVersion":{"type":["string","null"]},"sourcePlanVersion":{"type":["string","null"]},"collectedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"queriedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"observationKind":{"type":"string","const":"CRAWL_SAMPLE"}},"required":["provider","product","candidateId","sourceCallId","sourceSchemaVersion","sourcePlanVersion","collectedAt","queriedAt","observationKind"],"additionalProperties":false},"coverage":{"type":"object","properties":{"sampled":{"type":"boolean","const":true},"maxCrawlPages":{"type":["integer","null"],"minimum":0},"pagesCrawled":{"type":["integer","null"],"minimum":0},"stopReason":{"type":["string","null"]},"providerTotal":{"type":["integer","null"],"minimum":0},"returnedCount":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"invalidItemCount":{"type":"integer","minimum":0}},"required":["sampled","maxCrawlPages","pagesCrawled","stopReason","providerTotal","returnedCount","offset","limit","truncated","invalidItemCount"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"statusCode":{"type":["integer","null"],"minimum":100,"maximum":599},"title":{"type":["string","null"],"maxLength":4096},"description":{"type":["string","null"],"maxLength":4096},"canonical":{"type":["string","null"],"maxLength":2048},"sizeBytes":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"onpageScore":{"type":["number","null"],"minimum":0,"maximum":100},"checks":{"type":"object","properties":{"isBroken":{"type":["boolean","null"]},"is4xx":{"type":["boolean","null"]},"is5xx":{"type":["boolean","null"]},"isHttps":{"type":["boolean","null"]},"noH1":{"type":["boolean","null"]},"noDescription":{"type":["boolean","null"]},"hasMicromarkup":{"type":["boolean","null"]},"hasMicromarkupErrors":{"type":["boolean","null"]}},"required":["isBroken","is4xx","is5xx","isHttps","noH1","noDescription","hasMicromarkup","hasMicromarkupErrors"],"additionalProperties":false}},"required":["url","statusCode","title","description","canonical","sizeBytes","onpageScore","checks"],"additionalProperties":false},"maxItems":10},"missingFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"}},"required":["field","reason"],"additionalProperties":false},"maxItems":10000},"warnings":{"type":"array","items":{"type":"string"},"maxItems":1000}},"required":["source","coverage","items","missingFields","warnings"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"website-page-checks","x-nexscope-mcp-tool-name":"nexscope_website_page_checks","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/resource-affected-pages/run":{"post":{"tags":["Pages & Websites"],"summary":"Resource Affected Pages","description":"Resource Affected Pages from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.","operationId":"runResourceAffectedPages","externalDocs":{"description":"Resource Affected Pages documentation","url":"https://www.nexscope.ai/api-docs/resource-affected-pages"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","minLength":1,"maxLength":64},"resourceUrl":{"type":"string","maxLength":2048,"format":"uri"},"limit":{"type":"integer","default":10,"minimum":1,"maximum":10}},"required":["task_id","resourceUrl"],"additionalProperties":false},"example":{"resourceUrl":"https://cdn.example.com/a.js","task_id":"source-call"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"source":{"type":"object","properties":{"provider":{"type":"string","const":"DATAFORSEO"},"product":{"type":"string","const":"on_page"},"candidateId":{"type":"string","const":"MD-PW-04"},"sourceCallId":{"type":["string","null"]},"sourceSchemaVersion":{"type":["string","null"]},"sourcePlanVersion":{"type":["string","null"]},"collectedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"queriedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"observationKind":{"type":"string","const":"CRAWL_SAMPLE"}},"required":["provider","product","candidateId","sourceCallId","sourceSchemaVersion","sourcePlanVersion","collectedAt","queriedAt","observationKind"],"additionalProperties":false},"coverage":{"type":"object","properties":{"sampled":{"type":"boolean","const":true},"maxCrawlPages":{"type":["integer","null"],"minimum":0},"pagesCrawled":{"type":["integer","null"],"minimum":0},"stopReason":{"type":["string","null"]},"providerTotal":{"type":["integer","null"],"minimum":0},"returnedCount":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"invalidItemCount":{"type":"integer","minimum":0}},"required":["sampled","maxCrawlPages","pagesCrawled","stopReason","providerTotal","returnedCount","offset","limit","truncated","invalidItemCount"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"resourceUrl":{"type":"string","maxLength":2048},"page":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"statusCode":{"type":["integer","null"],"minimum":100,"maximum":599},"title":{"type":["string","null"],"maxLength":4096},"description":{"type":["string","null"],"maxLength":4096},"canonical":{"type":["string","null"],"maxLength":2048},"sizeBytes":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"onpageScore":{"type":["number","null"],"minimum":0,"maximum":100},"checks":{"type":"object","properties":{"isBroken":{"type":["boolean","null"]},"is4xx":{"type":["boolean","null"]},"is5xx":{"type":["boolean","null"]},"isHttps":{"type":["boolean","null"]},"noH1":{"type":["boolean","null"]},"noDescription":{"type":["boolean","null"]},"hasMicromarkup":{"type":["boolean","null"]},"hasMicromarkupErrors":{"type":["boolean","null"]}},"required":["isBroken","is4xx","is5xx","isHttps","noH1","noDescription","hasMicromarkup","hasMicromarkupErrors"],"additionalProperties":false}},"required":["url","statusCode","title","description","canonical","sizeBytes","onpageScore","checks"],"additionalProperties":false}},"required":["resourceUrl","page"],"additionalProperties":false},"maxItems":10},"missingFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"}},"required":["field","reason"],"additionalProperties":false},"maxItems":10000},"warnings":{"type":"array","items":{"type":"string"},"maxItems":1000}},"required":["source","coverage","items","missingFields","warnings"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"resource-affected-pages","x-nexscope-mcp-tool-name":"nexscope_resource_affected_pages","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/website-resource-status/run":{"post":{"tags":["Pages & Websites"],"summary":"Website Resource Status","description":"Website Resource Status from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.","operationId":"runWebsiteResourceStatus","externalDocs":{"description":"Website Resource Status documentation","url":"https://www.nexscope.ai/api-docs/website-resource-status"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","minLength":1,"maxLength":64},"pageUrl":{"type":"string","maxLength":2048,"format":"uri"},"limit":{"type":"integer","default":20,"minimum":1,"maximum":100},"offset":{"type":"integer","default":0,"minimum":0,"maximum":1000}},"required":["task_id"],"additionalProperties":false},"example":{"task_id":"source-call","pageUrl":"https://example.com/a"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"source":{"type":"object","properties":{"provider":{"type":"string","const":"DATAFORSEO"},"product":{"type":"string","const":"on_page"},"candidateId":{"type":"string","const":"MD-PW-05"},"sourceCallId":{"type":["string","null"]},"sourceSchemaVersion":{"type":["string","null"]},"sourcePlanVersion":{"type":["string","null"]},"collectedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"queriedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"observationKind":{"type":"string","const":"CRAWL_SAMPLE"}},"required":["provider","product","candidateId","sourceCallId","sourceSchemaVersion","sourcePlanVersion","collectedAt","queriedAt","observationKind"],"additionalProperties":false},"coverage":{"type":"object","properties":{"sampled":{"type":"boolean","const":true},"maxCrawlPages":{"type":["integer","null"],"minimum":0},"pagesCrawled":{"type":["integer","null"],"minimum":0},"stopReason":{"type":["string","null"]},"providerTotal":{"type":["integer","null"],"minimum":0},"returnedCount":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"invalidItemCount":{"type":"integer","minimum":0}},"required":["sampled","maxCrawlPages","pagesCrawled","stopReason","providerTotal","returnedCount","offset","limit","truncated","invalidItemCount"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"resourceType":{"type":["string","null"],"enum":["SCRIPT","IMAGE","STYLESHEET","BROKEN","UNKNOWN",null]},"providerStatusCode":{"type":["integer","null"],"minimum":100,"maximum":599},"sizeBytes":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"loadDurationMs":{"type":["number","null"],"minimum":0}},"required":["url","resourceType","providerStatusCode","sizeBytes","loadDurationMs"],"additionalProperties":false},"maxItems":100},"missingFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"}},"required":["field","reason"],"additionalProperties":false},"maxItems":10000},"warnings":{"type":"array","items":{"type":"string"},"maxItems":1000}},"required":["source","coverage","items","missingFields","warnings"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"website-resource-status","x-nexscope-mcp-tool-name":"nexscope_website_resource_status","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/duplicate-page-tags/run":{"post":{"tags":["Pages & Websites"],"summary":"Duplicate Page Tags","description":"Duplicate Page Tags from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.","operationId":"runDuplicatePageTags","externalDocs":{"description":"Duplicate Page Tags documentation","url":"https://www.nexscope.ai/api-docs/duplicate-page-tags"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","minLength":1,"maxLength":64},"tagType":{"type":"string","enum":["TITLE","DESCRIPTION"]},"limit":{"type":"integer","default":20,"minimum":1,"maximum":100},"offset":{"type":"integer","default":0,"minimum":0,"maximum":1000}},"required":["task_id","tagType"],"additionalProperties":false},"example":{"task_id":"source-call","tagType":"TITLE"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"source":{"type":"object","properties":{"provider":{"type":"string","const":"DATAFORSEO"},"product":{"type":"string","const":"on_page"},"candidateId":{"type":"string","const":"MD-PW-06"},"sourceCallId":{"type":["string","null"]},"sourceSchemaVersion":{"type":["string","null"]},"sourcePlanVersion":{"type":["string","null"]},"collectedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"queriedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"observationKind":{"type":"string","const":"CRAWL_SAMPLE"}},"required":["provider","product","candidateId","sourceCallId","sourceSchemaVersion","sourcePlanVersion","collectedAt","queriedAt","observationKind"],"additionalProperties":false},"coverage":{"type":"object","properties":{"sampled":{"type":"boolean","const":true},"maxCrawlPages":{"type":["integer","null"],"minimum":0},"pagesCrawled":{"type":["integer","null"],"minimum":0},"stopReason":{"type":["string","null"]},"providerTotal":{"type":["integer","null"],"minimum":0},"returnedCount":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"invalidItemCount":{"type":"integer","minimum":0}},"required":["sampled","maxCrawlPages","pagesCrawled","stopReason","providerTotal","returnedCount","offset","limit","truncated","invalidItemCount"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"tagType":{"type":"string","enum":["TITLE","DESCRIPTION"]},"value":{"type":"string","maxLength":4096},"totalCount":{"type":["integer","null"],"minimum":0},"pages":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"statusCode":{"type":["integer","null"],"minimum":100,"maximum":599}},"required":["url","statusCode"],"additionalProperties":false},"maxItems":10}},"required":["tagType","value","totalCount","pages"],"additionalProperties":false},"maxItems":100},"missingFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"}},"required":["field","reason"],"additionalProperties":false},"maxItems":10000},"warnings":{"type":"array","items":{"type":"string"},"maxItems":1000}},"required":["source","coverage","items","missingFields","warnings"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"duplicate-page-tags","x-nexscope-mcp-tool-name":"nexscope_duplicate_page_tags","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/duplicate-page-content/run":{"post":{"tags":["Pages & Websites"],"summary":"Duplicate Page Content","description":"Duplicate Page Content from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.","operationId":"runDuplicatePageContent","externalDocs":{"description":"Duplicate Page Content documentation","url":"https://www.nexscope.ai/api-docs/duplicate-page-content"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","minLength":1,"maxLength":64},"pageUrl":{"type":"string","maxLength":2048,"format":"uri"},"similarity":{"type":"integer","default":6,"minimum":0,"maximum":10},"limit":{"type":"integer","default":20,"minimum":1,"maximum":100},"offset":{"type":"integer","default":0,"minimum":0,"maximum":1000}},"required":["task_id","pageUrl"],"additionalProperties":false},"example":{"task_id":"source-call","pageUrl":"https://example.com/a"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"source":{"type":"object","properties":{"provider":{"type":"string","const":"DATAFORSEO"},"product":{"type":"string","const":"on_page"},"candidateId":{"type":"string","const":"MD-PW-07"},"sourceCallId":{"type":["string","null"]},"sourceSchemaVersion":{"type":["string","null"]},"sourcePlanVersion":{"type":["string","null"]},"collectedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"queriedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"observationKind":{"type":"string","const":"CRAWL_SAMPLE"}},"required":["provider","product","candidateId","sourceCallId","sourceSchemaVersion","sourcePlanVersion","collectedAt","queriedAt","observationKind"],"additionalProperties":false},"coverage":{"type":"object","properties":{"sampled":{"type":"boolean","const":true},"maxCrawlPages":{"type":["integer","null"],"minimum":0},"pagesCrawled":{"type":["integer","null"],"minimum":0},"stopReason":{"type":["string","null"]},"providerTotal":{"type":["integer","null"],"minimum":0},"returnedCount":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"invalidItemCount":{"type":"integer","minimum":0}},"required":["sampled","maxCrawlPages","pagesCrawled","stopReason","providerTotal","returnedCount","offset","limit","truncated","invalidItemCount"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"sourceUrl":{"type":"string","maxLength":2048},"url":{"type":"string","maxLength":2048},"statusCode":{"type":["integer","null"],"minimum":100,"maximum":599},"similarity":{"type":["number","null"],"minimum":0,"maximum":10}},"required":["sourceUrl","url","statusCode","similarity"],"additionalProperties":false},"maxItems":100},"missingFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"}},"required":["field","reason"],"additionalProperties":false},"maxItems":10000},"warnings":{"type":"array","items":{"type":"string"},"maxItems":1000}},"required":["source","coverage","items","missingFields","warnings"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"duplicate-page-content","x-nexscope-mcp-tool-name":"nexscope_duplicate_page_content","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/website-links/run":{"post":{"tags":["Pages & Websites"],"summary":"Website Links","description":"Website Links from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.","operationId":"runWebsiteLinks","externalDocs":{"description":"Website Links documentation","url":"https://www.nexscope.ai/api-docs/website-links"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","minLength":1,"maxLength":64},"limit":{"type":"integer","default":20,"minimum":1,"maximum":100},"offset":{"type":"integer","default":0,"minimum":0,"maximum":1000}},"required":["task_id"],"additionalProperties":false},"example":{"task_id":"source-call"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"source":{"type":"object","properties":{"provider":{"type":"string","const":"DATAFORSEO"},"product":{"type":"string","const":"on_page"},"candidateId":{"type":"string","const":"MD-PW-08"},"sourceCallId":{"type":["string","null"]},"sourceSchemaVersion":{"type":["string","null"]},"sourcePlanVersion":{"type":["string","null"]},"collectedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"queriedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"observationKind":{"type":"string","const":"CRAWL_SAMPLE"}},"required":["provider","product","candidateId","sourceCallId","sourceSchemaVersion","sourcePlanVersion","collectedAt","queriedAt","observationKind"],"additionalProperties":false},"coverage":{"type":"object","properties":{"sampled":{"type":"boolean","const":true},"maxCrawlPages":{"type":["integer","null"],"minimum":0},"pagesCrawled":{"type":["integer","null"],"minimum":0},"stopReason":{"type":["string","null"]},"providerTotal":{"type":["integer","null"],"minimum":0},"returnedCount":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"invalidItemCount":{"type":"integer","minimum":0}},"required":["sampled","maxCrawlPages","pagesCrawled","stopReason","providerTotal","returnedCount","offset","limit","truncated","invalidItemCount"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"type":{"type":["string","null"],"enum":["ANCHOR","IMAGE","CANONICAL","META","ALTERNATE","REDIRECT","UNKNOWN",null]},"fromUrl":{"type":"string","maxLength":2048},"toUrl":{"type":"string","maxLength":2048},"direction":{"type":["string","null"],"enum":["INTERNAL","EXTERNAL","UNKNOWN",null]},"broken":{"type":["boolean","null"]},"dofollow":{"type":["boolean","null"]},"targetStatusCode":{"type":["integer","null"],"minimum":100,"maximum":599},"text":{"type":["string","null"],"maxLength":4096}},"required":["type","fromUrl","toUrl","direction","broken","dofollow","targetStatusCode","text"],"additionalProperties":false},"maxItems":100},"missingFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"}},"required":["field","reason"],"additionalProperties":false},"maxItems":10000},"warnings":{"type":"array","items":{"type":"string"},"maxItems":1000}},"required":["source","coverage","items","missingFields","warnings"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"website-links","x-nexscope-mcp-tool-name":"nexscope_website_links","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/website-redirect-chains/run":{"post":{"tags":["Pages & Websites"],"summary":"Website Redirect Chains","description":"Website Redirect Chains from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.","operationId":"runWebsiteRedirectChains","externalDocs":{"description":"Website Redirect Chains documentation","url":"https://www.nexscope.ai/api-docs/website-redirect-chains"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","minLength":1,"maxLength":64},"pageUrl":{"type":"string","maxLength":2048,"format":"uri"},"limit":{"type":"integer","default":20,"minimum":1,"maximum":100},"offset":{"type":"integer","default":0,"minimum":0,"maximum":1000}},"required":["task_id"],"additionalProperties":false},"example":{"task_id":"source-call","pageUrl":"https://example.com/a"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"source":{"type":"object","properties":{"provider":{"type":"string","const":"DATAFORSEO"},"product":{"type":"string","const":"on_page"},"candidateId":{"type":"string","const":"MD-PW-09"},"sourceCallId":{"type":["string","null"]},"sourceSchemaVersion":{"type":["string","null"]},"sourcePlanVersion":{"type":["string","null"]},"collectedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"queriedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"observationKind":{"type":"string","const":"CRAWL_SAMPLE"}},"required":["provider","product","candidateId","sourceCallId","sourceSchemaVersion","sourcePlanVersion","collectedAt","queriedAt","observationKind"],"additionalProperties":false},"coverage":{"type":"object","properties":{"sampled":{"type":"boolean","const":true},"maxCrawlPages":{"type":["integer","null"],"minimum":0},"pagesCrawled":{"type":["integer","null"],"minimum":0},"stopReason":{"type":["string","null"]},"providerTotal":{"type":["integer","null"],"minimum":0},"returnedCount":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"invalidItemCount":{"type":"integer","minimum":0}},"required":["sampled","maxCrawlPages","pagesCrawled","stopReason","providerTotal","returnedCount","offset","limit","truncated","invalidItemCount"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"loop":{"type":["boolean","null"]},"hops":{"type":"array","items":{"type":"object","properties":{"fromUrl":{"type":"string","maxLength":2048},"toUrl":{"type":"string","maxLength":2048}},"required":["fromUrl","toUrl"],"additionalProperties":false},"maxItems":20}},"required":["loop","hops"],"additionalProperties":false},"maxItems":100},"missingFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"}},"required":["field","reason"],"additionalProperties":false},"maxItems":10000},"warnings":{"type":"array","items":{"type":"string"},"maxItems":1000}},"required":["source","coverage","items","missingFields","warnings"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"website-redirect-chains","x-nexscope-mcp-tool-name":"nexscope_website_redirect_chains","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/non-indexable-pages/run":{"post":{"tags":["Pages & Websites"],"summary":"Non Indexable Pages","description":"Non Indexable Pages from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.","operationId":"runNonIndexablePages","externalDocs":{"description":"Non Indexable Pages documentation","url":"https://www.nexscope.ai/api-docs/non-indexable-pages"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","minLength":1,"maxLength":64},"limit":{"type":"integer","default":20,"minimum":1,"maximum":100},"offset":{"type":"integer","default":0,"minimum":0,"maximum":1000}},"required":["task_id"],"additionalProperties":false},"example":{"task_id":"source-call"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"source":{"type":"object","properties":{"provider":{"type":"string","const":"DATAFORSEO"},"product":{"type":"string","const":"on_page"},"candidateId":{"type":"string","const":"MD-PW-10"},"sourceCallId":{"type":["string","null"]},"sourceSchemaVersion":{"type":["string","null"]},"sourcePlanVersion":{"type":["string","null"]},"collectedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"queriedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"observationKind":{"type":"string","const":"CRAWL_SAMPLE"}},"required":["provider","product","candidateId","sourceCallId","sourceSchemaVersion","sourcePlanVersion","collectedAt","queriedAt","observationKind"],"additionalProperties":false},"coverage":{"type":"object","properties":{"sampled":{"type":"boolean","const":true},"maxCrawlPages":{"type":["integer","null"],"minimum":0},"pagesCrawled":{"type":["integer","null"],"minimum":0},"stopReason":{"type":["string","null"]},"providerTotal":{"type":["integer","null"],"minimum":0},"returnedCount":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"invalidItemCount":{"type":"integer","minimum":0}},"required":["sampled","maxCrawlPages","pagesCrawled","stopReason","providerTotal","returnedCount","offset","limit","truncated","invalidItemCount"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"reason":{"type":["string","null"],"enum":["ROBOTS_TXT","META_TAG","HTTP_HEADER","ATTRIBUTE","TOO_MANY_REDIRECTS","UNKNOWN",null]}},"required":["url","reason"],"additionalProperties":false},"maxItems":100},"missingFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"}},"required":["field","reason"],"additionalProperties":false},"maxItems":10000},"warnings":{"type":"array","items":{"type":"string"},"maxItems":1000}},"required":["source","coverage","items","missingFields","warnings"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"non-indexable-pages","x-nexscope-mcp-tool-name":"nexscope_non_indexable_pages","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/page-loading-waterfall/run":{"post":{"tags":["Pages & Websites"],"summary":"Page Loading Waterfall","description":"Page Loading Waterfall from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.","operationId":"runPageLoadingWaterfall","externalDocs":{"description":"Page Loading Waterfall documentation","url":"https://www.nexscope.ai/api-docs/page-loading-waterfall"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","minLength":1,"maxLength":64},"pageUrl":{"type":"string","maxLength":2048,"format":"uri"}},"required":["task_id","pageUrl"],"additionalProperties":false},"example":{"task_id":"source-call","pageUrl":"https://example.com/a"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"source":{"type":"object","properties":{"provider":{"type":"string","const":"DATAFORSEO"},"product":{"type":"string","const":"on_page"},"candidateId":{"type":"string","const":"MD-PW-11"},"sourceCallId":{"type":["string","null"]},"sourceSchemaVersion":{"type":["string","null"]},"sourcePlanVersion":{"type":["string","null"]},"collectedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"queriedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"observationKind":{"type":"string","const":"CRAWL_SAMPLE"}},"required":["provider","product","candidateId","sourceCallId","sourceSchemaVersion","sourcePlanVersion","collectedAt","queriedAt","observationKind"],"additionalProperties":false},"coverage":{"type":"object","properties":{"sampled":{"type":"boolean","const":true},"maxCrawlPages":{"type":["integer","null"],"minimum":0},"pagesCrawled":{"type":["integer","null"],"minimum":0},"stopReason":{"type":["string","null"]},"providerTotal":{"type":["integer","null"],"minimum":0},"returnedCount":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"invalidItemCount":{"type":"integer","minimum":0}},"required":["sampled","maxCrawlPages","pagesCrawled","stopReason","providerTotal","returnedCount","offset","limit","truncated","invalidItemCount"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"pageUrl":{"type":"string","maxLength":2048},"interactiveMs":{"type":["number","null"],"minimum":0},"domCompleteMs":{"type":["number","null"],"minimum":0},"connectionMs":{"type":["number","null"],"minimum":0},"secureConnectionMs":{"type":["number","null"],"minimum":0},"waitMs":{"type":["number","null"],"minimum":0},"durationMs":{"type":["number","null"],"minimum":0},"resources":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"type":{"type":["string","null"]},"initiator":{"type":["string","null"],"maxLength":4096},"startMs":{"type":["number","null"],"minimum":0},"endMs":{"type":["number","null"],"minimum":0},"durationMs":{"type":["number","null"],"minimum":0},"renderBlocking":{"type":["boolean","null"]}},"required":["url","type","initiator","startMs","endMs","durationMs","renderBlocking"],"additionalProperties":false},"maxItems":200}},"required":["pageUrl","interactiveMs","domCompleteMs","connectionMs","secureConnectionMs","waitMs","durationMs","resources"],"additionalProperties":false},"maxItems":1},"missingFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"}},"required":["field","reason"],"additionalProperties":false},"maxItems":10000},"warnings":{"type":"array","items":{"type":"string"},"maxItems":1000}},"required":["source","coverage","items","missingFields","warnings"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"page-loading-waterfall","x-nexscope-mcp-tool-name":"nexscope_page_loading_waterfall","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/page-keyword-density/run":{"post":{"tags":["Pages & Websites"],"summary":"Page Keyword Density","description":"Page Keyword Density from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.","operationId":"runPageKeywordDensity","externalDocs":{"description":"Page Keyword Density documentation","url":"https://www.nexscope.ai/api-docs/page-keyword-density"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","minLength":1,"maxLength":64},"pageUrl":{"type":"string","maxLength":2048,"format":"uri"},"keywordLength":{"type":"integer","default":1,"minimum":1,"maximum":5},"limit":{"type":"integer","default":20,"minimum":1,"maximum":100}},"required":["task_id"],"additionalProperties":false},"example":{"task_id":"source-call","pageUrl":"https://example.com/a"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"source":{"type":"object","properties":{"provider":{"type":"string","const":"DATAFORSEO"},"product":{"type":"string","const":"on_page"},"candidateId":{"type":"string","const":"MD-PW-12"},"sourceCallId":{"type":["string","null"]},"sourceSchemaVersion":{"type":["string","null"]},"sourcePlanVersion":{"type":["string","null"]},"collectedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"queriedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"observationKind":{"type":"string","const":"CRAWL_SAMPLE"}},"required":["provider","product","candidateId","sourceCallId","sourceSchemaVersion","sourcePlanVersion","collectedAt","queriedAt","observationKind"],"additionalProperties":false},"coverage":{"type":"object","properties":{"sampled":{"type":"boolean","const":true},"maxCrawlPages":{"type":["integer","null"],"minimum":0},"pagesCrawled":{"type":["integer","null"],"minimum":0},"stopReason":{"type":["string","null"]},"providerTotal":{"type":["integer","null"],"minimum":0},"returnedCount":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"invalidItemCount":{"type":"integer","minimum":0}},"required":["sampled","maxCrawlPages","pagesCrawled","stopReason","providerTotal","returnedCount","offset","limit","truncated","invalidItemCount"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string","maxLength":4096},"frequency":{"type":["integer","null"],"minimum":0},"densityRatio":{"type":["number","null"],"minimum":0,"maximum":1}},"required":["keyword","frequency","densityRatio"],"additionalProperties":false},"maxItems":100},"missingFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"}},"required":["field","reason"],"additionalProperties":false},"maxItems":10000},"warnings":{"type":"array","items":{"type":"string"},"maxItems":1000}},"required":["source","coverage","items","missingFields","warnings"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"page-keyword-density","x-nexscope-mcp-tool-name":"nexscope_page_keyword_density","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/page-structured-data/run":{"post":{"tags":["Pages & Websites"],"summary":"Page Structured Data","description":"Page Structured Data from a bounded crawl sample. Returns typed source evidence and missing-field diagnostics. Source ownership, version, expiry and membership are checked when run. This sample does not describe every page of a website.","operationId":"runPageStructuredData","externalDocs":{"description":"Page Structured Data documentation","url":"https://www.nexscope.ai/api-docs/page-structured-data"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","minLength":1,"maxLength":64},"pageUrl":{"type":"string","maxLength":2048,"format":"uri"}},"required":["task_id","pageUrl"],"additionalProperties":false},"example":{"task_id":"source-call","pageUrl":"https://example.com/a"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"source":{"type":"object","properties":{"provider":{"type":"string","const":"DATAFORSEO"},"product":{"type":"string","const":"on_page"},"candidateId":{"type":"string","const":"MD-PW-13"},"sourceCallId":{"type":["string","null"]},"sourceSchemaVersion":{"type":["string","null"]},"sourcePlanVersion":{"type":["string","null"]},"collectedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"queriedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"observationKind":{"type":"string","const":"CRAWL_SAMPLE"}},"required":["provider","product","candidateId","sourceCallId","sourceSchemaVersion","sourcePlanVersion","collectedAt","queriedAt","observationKind"],"additionalProperties":false},"coverage":{"type":"object","properties":{"sampled":{"type":"boolean","const":true},"maxCrawlPages":{"type":["integer","null"],"minimum":0},"pagesCrawled":{"type":["integer","null"],"minimum":0},"stopReason":{"type":["string","null"]},"providerTotal":{"type":["integer","null"],"minimum":0},"returnedCount":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"invalidItemCount":{"type":"integer","minimum":0}},"required":["sampled","maxCrawlPages","pagesCrawled","stopReason","providerTotal","returnedCount","offset","limit","truncated","invalidItemCount"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"testSummary":{"type":"object","properties":{"fatal":{"type":["integer","null"],"minimum":0},"error":{"type":["integer","null"],"minimum":0},"warning":{"type":["integer","null"],"minimum":0},"info":{"type":["integer","null"],"minimum":0}},"required":["fatal","error","warning","info"],"additionalProperties":false},"documents":{"type":"array","items":{"type":"object","properties":{"format":{"type":"string","const":"JSON_LD"},"types":{"type":"array","items":{"type":"string"},"maxItems":100},"fields":{"type":"array","items":{"$ref":"#/$defs/MarkupField"},"maxItems":200}},"required":["format","types","fields"],"additionalProperties":false},"maxItems":200}},"required":["testSummary","documents"],"additionalProperties":false},"maxItems":1},"missingFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"}},"required":["field","reason"],"additionalProperties":false},"maxItems":10000},"warnings":{"type":"array","items":{"type":"string"},"maxItems":1000}},"required":["source","coverage","items","missingFields","warnings"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}},"$defs":{"MarkupField":{"type":"object","properties":{"name":{"type":"string"},"types":{"type":"array","items":{"type":"string"},"maxItems":100},"values":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"STRING"},"value":{"type":"string","maxLength":4096}},"required":["kind","value"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"NUMBER"},"value":{"type":"number"}},"required":["kind","value"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"BOOLEAN"},"value":{"type":"boolean"}},"required":["kind","value"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"NULL"},"value":{"type":"null"}},"required":["kind","value"],"additionalProperties":false}]},"maxItems":100},"children":{"type":"array","items":{"$ref":"#/$defs/MarkupField"},"maxItems":200},"issues":{"type":"array","items":{"type":"object","properties":{"level":{"type":"string","enum":["fatal","error","warning","info"]},"message":{"type":"string","maxLength":4096}},"required":["level","message"],"additionalProperties":false},"maxItems":100}},"required":["name","types","values","children","issues"],"additionalProperties":false}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"page-structured-data","x-nexscope-mcp-tool-name":"nexscope_page_structured_data","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/page-screenshot/run":{"post":{"tags":["Pages & Websites"],"summary":"Page Screenshot","description":"Page screenshot with explicit observation scope and missing evidence. Uses a fixed bounded plan. Source and image facts retain their observation time; a screenshot does not prove current indexing or complete website coverage.","operationId":"runPageScreenshot","externalDocs":{"description":"Page Screenshot documentation","url":"https://www.nexscope.ai/api-docs/page-screenshot"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"device":{"type":"string","enum":["DESKTOP","MOBILE"],"default":"DESKTOP"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://example.com/a"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"source":{"type":"object","properties":{"provider":{"type":"string","const":"DATAFORSEO"},"product":{"type":"string","const":"on_page"},"candidateId":{"type":"string","const":"MD-PW-14"},"sourceCallId":{"type":["string","null"]},"sourceSchemaVersion":{"type":["string","null"]},"sourcePlanVersion":{"type":["string","null"]},"collectedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"queriedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"observationKind":{"type":"string","const":"LIVE_PAGE_RENDER"}},"required":["provider","product","candidateId","sourceCallId","sourceSchemaVersion","sourcePlanVersion","collectedAt","queriedAt","observationKind"],"additionalProperties":false},"coverage":{"type":"object","properties":{"sampled":{"type":"boolean","const":true},"maxCrawlPages":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"pagesCrawled":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"stopReason":{"type":["string","null"]},"providerTotal":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"returnedCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"type":"integer","minimum":0,"maximum":9007199254740991},"truncated":{"type":"boolean"},"invalidItemCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["sampled","maxCrawlPages","pagesCrawled","stopReason","providerTotal","returnedCount","offset","limit","truncated","invalidItemCount"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"device":{"type":"string","enum":["DESKTOP","MOBILE"]},"capturedAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"image":{"type":["object","null"],"properties":{"artifactId":{"type":"string"},"mediaType":{"type":"string","enum":["image/png","image/jpeg"]},"byteLength":{"type":"integer","minimum":0,"maximum":9007199254740991},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"width":{"type":"integer","minimum":0,"maximum":9007199254740991},"height":{"type":"integer","minimum":0,"maximum":9007199254740991},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"downloadPath":{"type":"string"}},"required":["artifactId","mediaType","byteLength","sha256","width","height","expiresAt","downloadPath"],"additionalProperties":false}},"required":["url","device","capturedAt","image"],"additionalProperties":false},"maxItems":1},"missingFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string"}},"required":["field","reason"],"additionalProperties":false},"maxItems":10000},"warnings":{"type":"array","items":{"type":"string"},"maxItems":1000}},"required":["source","coverage","items","missingFields","warnings"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"page-screenshot","x-nexscope-mcp-tool-name":"nexscope_page_screenshot","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/page-lighthouse/run":{"post":{"tags":["Pages & Websites"],"summary":"Page Lighthouse Laboratory Evidence","description":"Page Lighthouse Laboratory Evidence. Bounded Lighthouse laboratory facts with explicit missing evidence. One submit and at most six fixed reads. Missing values are not zero. Prices and publication are unapproved. Successful owner-only results remain available in call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runPageLighthouse","externalDocs":{"description":"Page Lighthouse Laboratory Evidence documentation","url":"https://www.nexscope.ai/api-docs/page-lighthouse"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"device":{"type":"string","enum":["DESKTOP","MOBILE"],"default":"DESKTOP"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://example.com/"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"source":{"type":"object","properties":{"provider":{"type":"string","const":"DATAFORSEO"},"product":{"type":"string","const":"on_page"},"candidateId":{"type":"string","const":"MD-PW-15"},"sourceCallId":{"type":["string","null"]},"sourceSchemaVersion":{"type":["string","null"]},"sourcePlanVersion":{"type":["string","null"]},"collectedAt":{"type":["integer","null"],"minimum":0},"queriedAt":{"type":"integer","minimum":0},"observationKind":{"type":"string","const":"LAB_RUN"}},"required":["provider","product","candidateId","sourceCallId","sourceSchemaVersion","sourcePlanVersion","collectedAt","queriedAt","observationKind"],"additionalProperties":false},"coverage":{"type":"object","properties":{"sampled":{"type":"boolean","const":true},"maxCrawlPages":{"type":["integer","null"],"minimum":0},"pagesCrawled":{"type":["integer","null"],"minimum":0},"stopReason":{"type":["string","null"]},"providerTotal":{"type":["integer","null"],"minimum":0},"returnedCount":{"type":"integer","minimum":0,"maximum":1},"offset":{"type":"integer","const":0},"limit":{"type":"integer","const":1},"truncated":{"type":"boolean"},"invalidItemCount":{"type":"integer","minimum":0}},"required":["sampled","maxCrawlPages","pagesCrawled","stopReason","providerTotal","returnedCount","offset","limit","truncated","invalidItemCount"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"requestedUrl":{"type":"string"},"finalUrl":{"type":["string","null"]},"lighthouseVersion":{"type":["string","null"]},"fetchTime":{"type":["integer","null"],"minimum":0},"device":{"type":"string","enum":["DESKTOP","MOBILE"]},"categories":{"type":"object","properties":{"performance":{"type":["number","null"],"minimum":0,"maximum":1},"accessibility":{"type":["number","null"],"minimum":0,"maximum":1},"bestPractices":{"type":["number","null"],"minimum":0,"maximum":1},"seo":{"type":["number","null"],"minimum":0,"maximum":1}},"required":["performance","accessibility","bestPractices","seo"],"additionalProperties":false},"metrics":{"type":"object","properties":{"firstContentfulPaintMs":{"type":["number","null"],"minimum":0},"largestContentfulPaintMs":{"type":["number","null"],"minimum":0},"totalBlockingTimeMs":{"type":["number","null"],"minimum":0},"cumulativeLayoutShift":{"type":["number","null"],"minimum":0},"speedIndexMs":{"type":["number","null"],"minimum":0}},"required":["firstContentfulPaintMs","largestContentfulPaintMs","totalBlockingTimeMs","cumulativeLayoutShift","speedIndexMs"],"additionalProperties":false}},"required":["requestedUrl","finalUrl","lighthouseVersion","fetchTime","device","categories","metrics"],"additionalProperties":false},"maxItems":1},"missingFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["source","coverage","items","missingFields","warnings"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"page-lighthouse","x-nexscope-mcp-tool-name":"nexscope_page_lighthouse","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-model-answer-observation/run":{"post":{"tags":["AI Search & Citations"],"summary":"seo-model-answer-observation","description":"Single fixed model answer observation with no web search and at most512 output tokens. Nullable fields preserve missing evidence. Provider observations and estimates do not establish actual account performance. No additional calls or fallback.","operationId":"runSeoModelAnswerObservation","externalDocs":{"description":"seo-model-answer-observation documentation","url":"https://www.nexscope.ai/api-docs/seo-model-answer-observation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"maxLength":500,"description":"Trim/NFC; Unicode code point limit500; newline and tab allowed. No tools/history/web options."}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":" Explain\nshoes + 50% "}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"meta":{"type":"object","properties":{"source":{"type":"string","const":"DATAFORSEO_MODEL_API"},"sampledAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"retrievedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"market":{"type":"null"},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"reason":{"type":"string","enum":["MISSING","NULL","INVALID","UNSUPPORTED","TRUNCATED"]}},"required":["path","reason"],"additionalProperties":false},"minItems":0,"maxItems":100},"missingOverflow":{"type":"boolean"}},"required":["source","sampledAt","retrievedAt","market","truncated","missing","missingOverflow"],"additionalProperties":false},"prompt":{"type":"string"},"requestedModel":{"type":"string","const":"gpt-4.1-mini-2025-04-14"},"observedModel":{"type":["string","null"]},"answerText":{"type":["string","null"],"maxLength":65536},"inputTokens":{"type":["integer","null"],"minimum":0},"outputTokens":{"type":["integer","null"],"minimum":0},"reasoningTokens":{"type":["integer","null"],"minimum":0},"webSearch":{"type":["boolean","null"]}},"required":["meta","prompt","requestedModel","observedModel","answerText","inputTokens","outputTokens","reasoningTokens","webSearch"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-model-answer-observation","x-nexscope-mcp-tool-name":"nexscope_seo_model_answer_observation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-ai-search-citation-sample/run":{"post":{"tags":["AI Search & Citations"],"summary":"AI Search Citation Sample","description":"AI Search Citation Sample. A bounded consumer ChatGPT answer and citation observation with explicit missing evidence. One submit and at most eight fixed reads. Missing values are not zero. Prices and publication are unapproved. Successful completed results remain available in owner call history. Seven-day source-freshness rules apply only to dependent requests.","operationId":"runSeoAiSearchCitationSample","externalDocs":{"description":"AI Search Citation Sample documentation","url":"https://www.nexscope.ai/api-docs/seo-ai-search-citation-sample"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"maxLength":2000}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Compare reusable packaging"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"meta":{"type":"object","properties":{"source":{"type":"string","const":"DATAFORSEO_CHATGPT_INTERFACE"},"sampledAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"retrievedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"market":{"type":"object","properties":{"country":{"type":"string","const":"US"},"locationCode":{"type":"integer","const":2840},"language":{"type":"string","const":"en"}},"required":["country","locationCode","language"],"additionalProperties":false},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"reason":{"type":"string","enum":["MISSING","NULL","INVALID","UNSUPPORTED","TRUNCATED"]}},"required":["path","reason"],"additionalProperties":false},"maxItems":100},"missingOverflow":{"type":"boolean"}},"required":["source","sampledAt","retrievedAt","market","truncated","missing","missingOverflow"],"additionalProperties":false},"prompt":{"type":"string","maxLength":2000},"model":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]},"answerMarkdown":{"anyOf":[{"type":"string","maxLength":65536},{"type":"null"}]},"checkUrl":{"anyOf":[{"type":"string","maxLength":4096},{"type":"null"}]},"citations":{"type":"array","items":{"type":"object","properties":{"title":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]},"snippet":{"anyOf":[{"type":"string","maxLength":8192},{"type":"null"}]},"domain":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]},"url":{"anyOf":[{"type":"string","maxLength":4096},{"type":"null"}]},"sourceName":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["title","snippet","domain","url","sourceName","publishedAt"],"additionalProperties":false},"maxItems":50}},"required":["meta","prompt","model","answerMarkdown","checkUrl","citations"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-ai-search-citation-sample","x-nexscope-mcp-tool-name":"nexscope_seo_ai_search_citation_sample","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-ai-mention-records/run":{"post":{"tags":["AI Search & Citations"],"summary":"seo-ai-mention-records","description":"Historical answer records with separate cited sources, search references and brand entities. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.","operationId":"runSeoAiMentionRecords","externalDocs":{"description":"seo-ai-mention-records documentation","url":"https://www.nexscope.ai/api-docs/seo-ai-mention-records"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"platform":{"type":"string","enum":["google","chat_gpt"],"default":"google"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["target"],"additionalProperties":false},"example":{"target":[{"kind":"DOMAIN","domain":" Example.COM "}],"platform":"chat_gpt"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"ai_optimization"},"sourceKind":{"type":"string","const":"llm_mentions_database"},"context":{"type":"object","properties":{"inputTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"normalizedTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"platform":{"type":"string","enum":["google","chat_gpt"]},"domainSearchScope":{"type":"string","const":"sources"},"keywordSearchScope":{"type":"string","const":"answer"},"ordering":{"type":"string","const":"ai_search_volume_desc"},"unsupportedDimensions":{"type":"array","items":{"type":"string","enum":["searchResults","brands"]},"minItems":0,"maxItems":2}},"required":["inputTargets","normalizedTargets","platform","domainSearchScope","keywordSearchScope","ordering","unsupportedDimensions"],"additionalProperties":false},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"totalCount":{"type":["integer","null"],"minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"answerMarkdown":{"type":["string","null"]},"modelName":{"type":["string","null"]},"aiSearchVolume":{"type":["integer","null"],"minimum":0},"firstRecordedAt":{"type":["integer","null"],"minimum":0},"lastRecordedAt":{"type":["integer","null"],"minimum":0},"webSearchBased":{"type":["boolean","null"]},"sources":{"type":["array","null"],"items":{"type":"object","properties":{"url":{"type":"string"},"domain":{"type":["string","null"]},"title":{"type":["string","null"]},"rank":{"type":["integer","null"],"minimum":0},"publishedAt":{"type":["integer","null"],"minimum":0}},"required":["url","domain","title","rank","publishedAt"],"additionalProperties":false},"minItems":0,"maxItems":20},"searchResults":{"type":["array","null"],"items":{"type":"object","properties":{"url":{"type":"string"},"domain":{"type":["string","null"]},"title":{"type":["string","null"]},"rank":{"type":["integer","null"],"minimum":0},"publishedAt":{"type":["integer","null"],"minimum":0}},"required":["url","domain","title","rank","publishedAt"],"additionalProperties":false},"minItems":0,"maxItems":20},"brands":{"type":["array","null"],"items":{"type":"object","properties":{"title":{"type":"string"},"category":{"type":["string","null"]},"rank":{"type":["integer","null"],"minimum":0}},"required":["title","category","rank"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["question","answerMarkdown","modelName","aiSearchVolume","firstRecordedAt","lastRecordedAt","webSearchBased","sources","searchResults","brands","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["market","language","sourceProduct","sourceKind","context","returnedCount","truncated","totalCount","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-ai-mention-records","x-nexscope-mcp-tool-name":"nexscope_seo_ai_mention_records","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-ai-target-metrics/run":{"post":{"tags":["AI Search & Citations"],"summary":"seo-ai-target-metrics","description":"AI target metrics from provider database aggregates. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.","operationId":"runSeoAiTargetMetrics","externalDocs":{"description":"seo-ai-target-metrics documentation","url":"https://www.nexscope.ai/api-docs/seo-ai-target-metrics"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"platform":{"type":"string","enum":["google","chat_gpt"],"default":"google"}},"required":["target"],"additionalProperties":false},"example":{"target":[{"kind":"DOMAIN","domain":" Example.COM "},{"kind":"KEYWORD","keyword":" Shoes "}]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"ai_optimization"},"sourceKind":{"type":"string","const":"llm_mentions_database"},"context":{"type":"object","properties":{"inputTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"normalizedTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"platform":{"type":"string","enum":["google","chat_gpt"],"default":"google"},"domainSearchScope":{"type":"string","const":"sources"},"keywordSearchScope":{"type":"string","const":"answer"},"unsupportedDimensions":{"type":"array","items":{"type":"string","enum":["searchResultDomains","brands","brandCategories"]},"minItems":0,"maxItems":3}},"required":["inputTargets","normalizedTargets","platform","domainSearchScope","keywordSearchScope","unsupportedDimensions"],"additionalProperties":false},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"metrics":{"type":"object","properties":{"total":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false},"sourceDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"searchResultDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brands":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brandCategories":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10}},"required":["total","sourceDomains","searchResultDomains","brands","brandCategories"],"additionalProperties":false}},"required":["market","language","sourceProduct","sourceKind","context","returnedCount","truncated","missing","metrics"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-ai-target-metrics","x-nexscope-mcp-tool-name":"nexscope_seo_ai_target_metrics","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-ai-target-comparison/run":{"post":{"tags":["AI Search & Citations"],"summary":"seo-ai-target-comparison","description":"Independent target group metrics and provider union aggregate without summing overlapping groups. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.","operationId":"runSeoAiTargetComparison","externalDocs":{"description":"seo-ai-target-comparison documentation","url":"https://www.nexscope.ai/api-docs/seo-ai-target-comparison"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"platform":{"type":"string","enum":["google","chat_gpt"],"default":"google"},"groups":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":80},"target":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword"],"additionalProperties":false}]},"minItems":1,"maxItems":10}},"required":["key","target"],"additionalProperties":false},"minItems":2,"maxItems":10}},"required":["groups"],"additionalProperties":false},"example":{"groups":[{"key":" A ","target":[{"kind":"DOMAIN","domain":" Example.COM "}]},{"key":"B","target":[{"kind":"KEYWORD","keyword":" Shoes "}]}]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"ai_optimization"},"sourceKind":{"type":"string","const":"llm_mentions_database"},"context":{"type":"object","properties":{"platform":{"type":"string","enum":["google","chat_gpt"],"default":"google"},"domainSearchScope":{"type":"string","const":"sources"},"keywordSearchScope":{"type":"string","const":"answer"},"unsupportedDimensions":{"type":"array","items":{"type":"string","enum":["searchResultDomains","brands","brandCategories"]},"minItems":0,"maxItems":3},"groups":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"inputTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"normalizedTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10}},"required":["key","inputTargets","normalizedTargets"],"additionalProperties":false},"minItems":2,"maxItems":10}},"required":["platform","domainSearchScope","keywordSearchScope","unsupportedDimensions","groups"],"additionalProperties":false},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"unionMetrics":{"type":"object","properties":{"total":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false},"sourceDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"searchResultDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brands":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brandCategories":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10}},"required":["total","sourceDomains","searchResultDomains","brands","brandCategories"],"additionalProperties":false},"groups":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"metrics":{"type":"object","properties":{"total":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false},"sourceDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"searchResultDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brands":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brandCategories":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10}},"required":["total","sourceDomains","searchResultDomains","brands","brandCategories"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["key","metrics","missing"],"additionalProperties":false},"minItems":2,"maxItems":10}},"required":["market","language","sourceProduct","sourceKind","context","returnedCount","truncated","missing","unionMetrics","groups"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-ai-target-comparison","x-nexscope-mcp-tool-name":"nexscope_seo_ai_target_comparison","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-ai-top-cited-pages/run":{"post":{"tags":["AI Search & Citations"],"summary":"seo-ai-top-cited-pages","description":"Provider ranked cited pages and their independent aggregate metrics. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.","operationId":"runSeoAiTopCitedPages","externalDocs":{"description":"seo-ai-top-cited-pages documentation","url":"https://www.nexscope.ai/api-docs/seo-ai-top-cited-pages"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"platform":{"type":"string","enum":["google","chat_gpt"],"default":"google"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["target"],"additionalProperties":false},"example":{"target":[{"kind":"DOMAIN","domain":" Example.COM "},{"kind":"KEYWORD","keyword":" Shoes "}]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"ai_optimization"},"sourceKind":{"type":"string","const":"llm_mentions_database"},"context":{"type":"object","properties":{"inputTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"normalizedTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"platform":{"type":"string","enum":["google","chat_gpt"],"default":"google"},"domainSearchScope":{"type":"string","const":"sources"},"keywordSearchScope":{"type":"string","const":"answer"},"unsupportedDimensions":{"type":"array","items":{"type":"string","enum":["searchResultDomains","brands","brandCategories"]},"minItems":0,"maxItems":3},"ordering":{"type":"string","const":"provider_default"},"linksScope":{"type":"string","const":"sources"}},"required":["inputTargets","normalizedTargets","platform","domainSearchScope","keywordSearchScope","unsupportedDimensions","ordering","linksScope"],"additionalProperties":false},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"summary":{"type":"object","properties":{"total":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false},"sourceDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"searchResultDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brands":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brandCategories":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10}},"required":["total","sourceDomains","searchResultDomains","brands","brandCategories"],"additionalProperties":false},"totalCount":{"type":["integer","null"],"minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"metrics":{"type":"object","properties":{"total":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false},"sourceDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"searchResultDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brands":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brandCategories":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10}},"required":["total","sourceDomains","searchResultDomains","brands","brandCategories"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["url","metrics","missing"],"additionalProperties":false},"minItems":0,"maxItems":20}},"required":["market","language","sourceProduct","sourceKind","context","returnedCount","truncated","missing","summary","totalCount","items"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-ai-top-cited-pages","x-nexscope-mcp-tool-name":"nexscope_seo_ai_top_cited_pages","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-ai-top-cited-domains/run":{"post":{"tags":["AI Search & Citations"],"summary":"seo-ai-top-cited-domains","description":"Provider ranked cited domains without merging subdomains. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.","operationId":"runSeoAiTopCitedDomains","externalDocs":{"description":"seo-ai-top-cited-domains documentation","url":"https://www.nexscope.ai/api-docs/seo-ai-top-cited-domains"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"platform":{"type":"string","enum":["google","chat_gpt"],"default":"google"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["target"],"additionalProperties":false},"example":{"target":[{"kind":"DOMAIN","domain":" Example.COM "},{"kind":"KEYWORD","keyword":" Shoes "}]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"ai_optimization"},"sourceKind":{"type":"string","const":"llm_mentions_database"},"context":{"type":"object","properties":{"inputTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"normalizedTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"platform":{"type":"string","enum":["google","chat_gpt"],"default":"google"},"domainSearchScope":{"type":"string","const":"sources"},"keywordSearchScope":{"type":"string","const":"answer"},"unsupportedDimensions":{"type":"array","items":{"type":"string","enum":["searchResultDomains","brands","brandCategories"]},"minItems":0,"maxItems":3},"ordering":{"type":"string","const":"provider_default"},"linksScope":{"type":"string","const":"sources"}},"required":["inputTargets","normalizedTargets","platform","domainSearchScope","keywordSearchScope","unsupportedDimensions","ordering","linksScope"],"additionalProperties":false},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"summary":{"type":"object","properties":{"total":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false},"sourceDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"searchResultDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brands":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brandCategories":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10}},"required":["total","sourceDomains","searchResultDomains","brands","brandCategories"],"additionalProperties":false},"totalCount":{"type":["integer","null"],"minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"metrics":{"type":"object","properties":{"total":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false},"sourceDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"searchResultDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brands":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brandCategories":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10}},"required":["total","sourceDomains","searchResultDomains","brands","brandCategories"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["domain","metrics","missing"],"additionalProperties":false},"minItems":0,"maxItems":20}},"required":["market","language","sourceProduct","sourceKind","context","returnedCount","truncated","missing","summary","totalCount","items"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-ai-top-cited-domains","x-nexscope-mcp-tool-name":"nexscope_seo_ai_top_cited_domains","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-ai-top-mentioned-brands/run":{"post":{"tags":["AI Search & Citations"],"summary":"seo-ai-top-mentioned-brands","description":"ChatGPT database brand mentions with provider brand taxonomy. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.","operationId":"runSeoAiTopMentionedBrands","externalDocs":{"description":"seo-ai-top-mentioned-brands documentation","url":"https://www.nexscope.ai/api-docs/seo-ai-top-mentioned-brands"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"platform":{"type":"string","enum":["chat_gpt"],"default":"chat_gpt"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["target"],"additionalProperties":false},"example":{"target":[{"kind":"DOMAIN","domain":" Example.COM "},{"kind":"KEYWORD","keyword":" Shoes "}]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"ai_optimization"},"sourceKind":{"type":"string","const":"llm_mentions_database"},"context":{"type":"object","properties":{"inputTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"normalizedTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"platform":{"type":"string","enum":["chat_gpt"],"default":"chat_gpt"},"domainSearchScope":{"type":"string","const":"sources"},"keywordSearchScope":{"type":"string","const":"answer"},"unsupportedDimensions":{"type":"array","items":{"type":"string","enum":["searchResultDomains","brands","brandCategories"]},"minItems":0,"maxItems":3},"ordering":{"type":"string","const":"provider_default"},"taxonomy":{"type":"string","const":"provider_brand_entities"}},"required":["inputTargets","normalizedTargets","platform","domainSearchScope","keywordSearchScope","unsupportedDimensions","ordering","taxonomy"],"additionalProperties":false},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"summary":{"type":"object","properties":{"total":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false},"sourceDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"searchResultDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brands":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brandCategories":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10}},"required":["total","sourceDomains","searchResultDomains","brands","brandCategories"],"additionalProperties":false},"totalCount":{"type":["integer","null"],"minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"brand":{"type":"string"},"metrics":{"type":"object","properties":{"total":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false},"sourceDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"searchResultDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brands":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brandCategories":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10}},"required":["total","sourceDomains","searchResultDomains","brands","brandCategories"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["brand","metrics","missing"],"additionalProperties":false},"minItems":0,"maxItems":20}},"required":["market","language","sourceProduct","sourceKind","context","returnedCount","truncated","missing","summary","totalCount","items"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-ai-top-mentioned-brands","x-nexscope-mcp-tool-name":"nexscope_seo_ai_top_mentioned_brands","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-ai-top-brand-categories/run":{"post":{"tags":["AI Search & Citations"],"summary":"seo-ai-top-brand-categories","description":"ChatGPT database brand categories with provider category labels. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.","operationId":"runSeoAiTopBrandCategories","externalDocs":{"description":"seo-ai-top-brand-categories documentation","url":"https://www.nexscope.ai/api-docs/seo-ai-top-brand-categories"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"platform":{"type":"string","enum":["chat_gpt"],"default":"chat_gpt"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["target"],"additionalProperties":false},"example":{"target":[{"kind":"DOMAIN","domain":" Example.COM "},{"kind":"KEYWORD","keyword":" Shoes "}]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"ai_optimization"},"sourceKind":{"type":"string","const":"llm_mentions_database"},"context":{"type":"object","properties":{"inputTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"normalizedTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"platform":{"type":"string","enum":["chat_gpt"],"default":"chat_gpt"},"domainSearchScope":{"type":"string","const":"sources"},"keywordSearchScope":{"type":"string","const":"answer"},"unsupportedDimensions":{"type":"array","items":{"type":"string","enum":["searchResultDomains","brands","brandCategories"]},"minItems":0,"maxItems":3},"ordering":{"type":"string","const":"provider_default"},"taxonomy":{"type":"string","const":"provider_brand_entities"}},"required":["inputTargets","normalizedTargets","platform","domainSearchScope","keywordSearchScope","unsupportedDimensions","ordering","taxonomy"],"additionalProperties":false},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"summary":{"type":"object","properties":{"total":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false},"sourceDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"searchResultDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brands":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brandCategories":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10}},"required":["total","sourceDomains","searchResultDomains","brands","brandCategories"],"additionalProperties":false},"totalCount":{"type":["integer","null"],"minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"brandCategory":{"type":"string"},"metrics":{"type":"object","properties":{"total":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false},"sourceDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"searchResultDomains":{"type":["array","null"],"items":{"type":"object","properties":{"domain":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["domain","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brands":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10},"brandCategories":{"type":["array","null"],"items":{"type":"object","properties":{"value":{"type":"string"},"counts":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false}},"required":["value","counts"],"additionalProperties":false},"minItems":0,"maxItems":10}},"required":["total","sourceDomains","searchResultDomains","brands","brandCategories"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["brandCategory","metrics","missing"],"additionalProperties":false},"minItems":0,"maxItems":20}},"required":["market","language","sourceProduct","sourceKind","context","returnedCount","truncated","missing","summary","totalCount","items"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-ai-top-brand-categories","x-nexscope-mcp-tool-name":"nexscope_seo_ai_top_brand_categories","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-ai-mention-history/run":{"post":{"tags":["AI Search & Citations"],"summary":"seo-ai-mention-history","description":"Monthly absolute mentions from the provider historical database. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.","operationId":"runSeoAiMentionHistory","externalDocs":{"description":"seo-ai-mention-history documentation","url":"https://www.nexscope.ai/api-docs/seo-ai-mention-history"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"platform":{"type":"string","enum":["google","chat_gpt"],"default":"google"},"fromMonth":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}$"},"toMonth":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}$"}},"required":["target","fromMonth","toMonth"],"additionalProperties":false},"example":{"toMonth":"2025-09","target":[{"kind":"DOMAIN","domain":" Example.COM "}],"fromMonth":"2025-08"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"ai_optimization"},"sourceKind":{"type":"string","const":"llm_mentions_database"},"context":{"type":"object","properties":{"inputTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"normalizedTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"platform":{"type":"string","enum":["google","chat_gpt"]},"domainSearchScope":{"type":"string","const":"sources"},"keywordSearchScope":{"type":"string","const":"answer"},"measure":{"type":"string","const":"monthly_absolute_mentions"},"fromMonth":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}$"},"toMonth":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}$"},"resolvedDateTo":{"type":"string","format":"date"},"partialCalendarMonth":{"type":"boolean"}},"required":["inputTargets","normalizedTargets","platform","domainSearchScope","keywordSearchScope","measure","fromMonth","toMonth","resolvedDateTo","partialCalendarMonth"],"additionalProperties":false},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"metrics":{"type":"object","properties":{"mentions":{"type":["integer","null"],"minimum":0},"aiSearchVolume":{"type":["integer","null"],"minimum":0}},"required":["mentions","aiSearchVolume"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["year","month","metrics","missing"],"additionalProperties":false},"minItems":0,"maxItems":12},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["market","language","sourceProduct","sourceKind","context","returnedCount","truncated","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-ai-mention-history","x-nexscope-mcp-tool-name":"nexscope_seo_ai_mention_history","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-ai-mention-deltas/run":{"post":{"tags":["AI Search & Citations"],"summary":"seo-ai-mention-deltas","description":"Provider adjacent timestamp deltas with signed independent values. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.","operationId":"runSeoAiMentionDeltas","externalDocs":{"description":"seo-ai-mention-deltas documentation","url":"https://www.nexscope.ai/api-docs/seo-ai-mention-deltas"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"platform":{"type":"string","enum":["google","chat_gpt"],"default":"google"},"dateFrom":{"type":"string","format":"date"},"dateTo":{"type":"string","format":"date"},"groupRange":{"type":"string","enum":["day","week","month","year"]}},"required":["target","dateFrom","dateTo","groupRange"],"additionalProperties":false},"example":{"dateTo":"2025-08-03","target":[{"kind":"DOMAIN","domain":" Example.COM "}],"dateFrom":"2025-08-01","groupRange":"week"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"ai_optimization"},"sourceKind":{"type":"string","const":"llm_mentions_database"},"context":{"type":"object","properties":{"inputTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"normalizedTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"platform":{"type":"string","enum":["google","chat_gpt"]},"domainSearchScope":{"type":"string","const":"sources"},"keywordSearchScope":{"type":"string","const":"answer"},"measure":{"type":"string","const":"provider_adjacent_timestamp_delta"},"dateFrom":{"type":"string","format":"date"},"dateTo":{"type":"string","format":"date"},"groupRange":{"type":"string","enum":["day","week","month","year"]}},"required":["inputTargets","normalizedTargets","platform","domainSearchScope","keywordSearchScope","measure","dateFrom","dateTo","groupRange"],"additionalProperties":false},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"mentionDelta":{"type":["integer","null"],"minimum":-9007199254740991},"aiSearchVolumeDelta":{"type":["integer","null"],"minimum":-9007199254740991},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["date","mentionDelta","aiSearchVolumeDelta","missing"],"additionalProperties":false},"minItems":0,"maxItems":366},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["market","language","sourceProduct","sourceKind","context","returnedCount","truncated","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-ai-mention-deltas","x-nexscope-mcp-tool-name":"nexscope_seo_ai_mention_deltas","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-ai-mention-new-lost/run":{"post":{"tags":["AI Search & Citations"],"summary":"seo-ai-mention-new-lost","description":"Provider new and lost mention statistics retained as separate nonnegative values. Historical provider database facts, not a live model execution. Domain filters use cited sources and keyword filters use answer text. Preserve nullable evidence and unsupported dimensions.","operationId":"runSeoAiMentionNewLost","externalDocs":{"description":"seo-ai-mention-new-lost documentation","url":"https://www.nexscope.ai/api-docs/seo-ai-mention-new-lost"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"},"platform":{"type":"string","enum":["google","chat_gpt"],"default":"google"},"dateFrom":{"type":"string","format":"date"},"dateTo":{"type":"string","format":"date"},"groupRange":{"type":"string","enum":["day","week","month","year"]}},"required":["target","dateFrom","dateTo","groupRange"],"additionalProperties":false},"example":{"dateTo":"2025-08-03","target":[{"kind":"DOMAIN","domain":" Example.COM "}],"dateFrom":"2025-08-01","groupRange":"week"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"ai_optimization"},"sourceKind":{"type":"string","const":"llm_mentions_database"},"context":{"type":"object","properties":{"inputTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"normalizedTargets":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"DOMAIN"},"domain":{"type":"string","minLength":1,"description":"Normalized ASCII hostname at most63 characters."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"includeSubdomains":{"type":"boolean","default":false}},"required":["kind","domain","searchFilter","includeSubdomains"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"KEYWORD"},"keyword":{"type":"string","minLength":1,"description":"Trim/NFC/lowercase1..80 code points,max10 words,no ASCII percent or plus."},"searchFilter":{"type":"string","enum":["include","exclude"],"default":"include"},"matchType":{"type":"string","enum":["word_match","partial_match"],"default":"word_match"}},"required":["kind","keyword","searchFilter","matchType"],"additionalProperties":false}]},"minItems":1,"maxItems":10},"platform":{"type":"string","enum":["google","chat_gpt"]},"domainSearchScope":{"type":"string","const":"sources"},"keywordSearchScope":{"type":"string","const":"answer"},"measure":{"type":"string","const":"provider_new_lost_statistics"},"dateFrom":{"type":"string","format":"date"},"dateTo":{"type":"string","format":"date"},"groupRange":{"type":"string","enum":["day","week","month","year"]}},"required":["inputTargets","normalizedTargets","platform","domainSearchScope","keywordSearchScope","measure","dateFrom","dateTo","groupRange"],"additionalProperties":false},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"newMentions":{"type":["integer","null"],"minimum":0},"lostMentions":{"type":["integer","null"],"minimum":0},"newAiSearchVolume":{"type":["integer","null"],"minimum":0},"lostAiSearchVolume":{"type":["integer","null"],"minimum":0},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["date","newMentions","lostMentions","newAiSearchVolume","lostAiSearchVolume","missing"],"additionalProperties":false},"minItems":0,"maxItems":366},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["market","language","sourceProduct","sourceKind","context","returnedCount","truncated","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-ai-mention-new-lost","x-nexscope-mcp-tool-name":"nexscope_seo_ai_mention_new_lost","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-ai-keyword-volume/run":{"post":{"tags":["AI Search & Citations"],"summary":"AI Keyword Search Volume Estimates","description":"People Also Ask statistical estimates of AI keyword search volume. These are provider estimates, not measured ChatGPT queries or Google Ads volume. Preserve missing keywords and monthly observations.","operationId":"runSeoAiKeywordVolume","externalDocs":{"description":"AI Keyword Search Volume Estimates documentation","url":"https://www.nexscope.ai/api-docs/seo-ai-keyword-volume"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keywords":{"type":"array","items":{"type":"string","minLength":1,"description":"Trim, NFC and lowercase,1..80 code points,at most10 words; ASCII percent and plus forbidden."},"minItems":1,"maxItems":20},"market":{"type":"string","const":"US","default":"US"},"language":{"type":"string","const":"en","default":"en"}},"required":["keywords"],"additionalProperties":false},"example":{"keywords":[" Shoes ","shoes"]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"market":{"type":"string","const":"US"},"language":{"type":"string","const":"en"},"sourceProduct":{"type":"string","const":"ai_optimization"},"sourceKind":{"type":"string","const":"ai_keyword_volume_estimate"},"context":{"type":"object","properties":{"inputKeywords":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":20},"normalizedKeywords":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":20},"method":{"type":"string","const":"provider_paa_statistical_estimate"}},"required":["inputKeywords","normalizedKeywords","method"],"additionalProperties":false},"returnedCount":{"type":"integer","minimum":0},"truncated":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"aiSearchVolume":{"type":["integer","null"],"minimum":0},"monthly":{"type":["array","null"],"items":{"type":"object","properties":{"year":{"type":"integer","minimum":1},"month":{"type":"integer","minimum":1,"maximum":12},"aiSearchVolume":{"type":["integer","null"],"minimum":0},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["year","month","aiSearchVolume","missing"],"additionalProperties":false},"minItems":0,"maxItems":12},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["keyword","aiSearchVolume","monthly","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["market","language","sourceProduct","sourceKind","context","returnedCount","truncated","items","missing"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-ai-keyword-volume","x-nexscope-mcp-tool-name":"nexscope_seo_ai_keyword_volume","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-backlink-overview/run":{"post":{"tags":["Backlinks & Authority"],"summary":"seo-backlink-overview","description":"Bounded summary projection from the Nexscope backlink index. Preserve target kind and provider scope. Proprietary rankings are not Google ratings or measured traffic. No pagination or additional provider calls. Unapproved costs prevent execution.","operationId":"runSeoBacklinkOverview","externalDocs":{"description":"seo-backlink-overview documentation","url":"https://www.nexscope.ai/api-docs/seo-backlink-overview"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false}},"required":["target"],"additionalProperties":false},"example":{"target":{"kind":"DOMAIN","target":" Example.COM. "}}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"sourceProduct":{"type":"string","const":"backlinks"},"sourceKind":{"type":"string","const":"dataforseo_backlink_index"},"inputTarget":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"normalizedTarget":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"rank":{"type":["integer","null"],"minimum":0,"maximum":1000},"targetSpamScore":{"type":["integer","null"],"minimum":0,"maximum":100},"backlinksSpamScore":{"type":["integer","null"],"minimum":0,"maximum":100},"backlinks":{"type":["integer","null"],"minimum":0},"crawledPages":{"type":["integer","null"],"minimum":0},"referringDomains":{"type":["integer","null"],"minimum":0},"referringMainDomains":{"type":["integer","null"],"minimum":0},"referringIps":{"type":["integer","null"],"minimum":0},"referringSubnets":{"type":["integer","null"],"minimum":0},"firstSeenAt":{"type":["integer","null"],"minimum":0},"lostAt":{"type":["integer","null"],"minimum":0},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["rank","targetSpamScore","backlinksSpamScore","backlinks","crawledPages","referringDomains","referringMainDomains","referringIps","referringSubnets","firstSeenAt","lostAt","missing"],"additionalProperties":false},"minItems":0,"maxItems":1},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"status":{"type":"string","const":"live"},"directLinksOnly":{"type":"boolean","const":true},"rankScale":{"type":"integer","const":1000},"scope":{"type":"string","enum":["DOMAIN","PAGE"]}},"required":["sourceProduct","sourceKind","inputTarget","normalizedTarget","returnedCount","items","missing","truncated","status","directLinksOnly","rankScale","scope"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-backlink-overview","x-nexscope-mcp-tool-name":"nexscope_seo_backlink_overview","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-backlink-history/run":{"post":{"tags":["Backlinks & Authority"],"summary":"seo-backlink-history","description":"Bounded calendar history values from the Nexscope backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.","operationId":"runSeoBacklinkHistory","externalDocs":{"description":"seo-backlink-history documentation","url":"https://www.nexscope.ai/api-docs/seo-backlink-history"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"string","minLength":1,"maxLength":254},"fromMonth":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}$"},"toMonth":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}$"}},"required":["target","fromMonth","toMonth"],"additionalProperties":false},"example":{"toMonth":"2026-03","target":"example.com","fromMonth":"2026-03"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"sourceProduct":{"type":"string","const":"backlinks"},"sourceKind":{"type":"string","const":"dataforseo_backlink_index"},"inputTarget":{"type":"string"},"normalizedTarget":{"type":"string"},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"snapshotAt":{"type":"integer","minimum":0},"month":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}$"},"rank":{"type":["integer","null"],"minimum":0,"maximum":1000},"backlinks":{"type":["integer","null"],"minimum":0},"crawledPages":{"type":["integer","null"],"minimum":0},"internalLinks":{"type":["integer","null"],"minimum":0},"externalLinks":{"type":["integer","null"],"minimum":0},"composition":{"type":"object","properties":{"brokenBacklinks":{"type":["integer","null"],"minimum":0},"brokenPages":{"type":["integer","null"],"minimum":0},"referringDomains":{"type":["integer","null"],"minimum":0},"referringMainDomains":{"type":["integer","null"],"minimum":0},"referringPages":{"type":["integer","null"],"minimum":0},"referringIps":{"type":["integer","null"],"minimum":0},"referringSubnets":{"type":["integer","null"],"minimum":0},"referringPagesNofollow":{"type":["integer","null"],"minimum":0},"linkTypes":{"type":"object","properties":{"anchor":{"type":["integer","null"],"minimum":0},"image":{"type":["integer","null"],"minimum":0},"link":{"type":["integer","null"],"minimum":0},"meta":{"type":["integer","null"],"minimum":0},"canonical":{"type":["integer","null"],"minimum":0},"alternate":{"type":["integer","null"],"minimum":0},"redirect":{"type":["integer","null"],"minimum":0}},"required":["anchor","image","link","meta","canonical","alternate","redirect"],"additionalProperties":false}},"required":["brokenBacklinks","brokenPages","referringDomains","referringMainDomains","referringPages","referringIps","referringSubnets","referringPagesNofollow","linkTypes"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["snapshotAt","month","rank","backlinks","crawledPages","internalLinks","externalLinks","composition","missing"],"additionalProperties":false},"minItems":0,"maxItems":12},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"fromMonth":{"type":"string"},"toMonth":{"type":"string"}},"required":["sourceProduct","sourceKind","inputTarget","normalizedTarget","returnedCount","items","missing","truncated","fromMonth","toMonth"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-backlink-history","x-nexscope-mcp-tool-name":"nexscope_seo_backlink_history","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-backlink-records/run":{"post":{"tags":["Backlinks & Authority"],"summary":"seo-backlink-records","description":"Bounded backlinks projection from the Nexscope backlink index. Preserve target kind and provider scope. Proprietary rankings are not Google ratings or measured traffic. No pagination or additional provider calls. Unapproved costs prevent execution.","operationId":"runSeoBacklinkRecords","externalDocs":{"description":"seo-backlink-records documentation","url":"https://www.nexscope.ai/api-docs/seo-backlink-records"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["target"],"additionalProperties":false},"example":{"target":{"kind":"DOMAIN","target":" Example.COM. "},"limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"sourceProduct":{"type":"string","const":"backlinks"},"sourceKind":{"type":"string","const":"dataforseo_backlink_index"},"inputTarget":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"normalizedTarget":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"fromUrl":{"type":"string"},"toUrl":{"type":"string"},"anchor":{"type":["string","null"]},"dofollow":{"type":["boolean","null"]},"rank":{"type":["integer","null"],"minimum":0,"maximum":1000},"spamScore":{"type":["integer","null"],"minimum":0,"maximum":100},"firstSeenAt":{"type":["integer","null"],"minimum":0},"lastSeenAt":{"type":["integer","null"],"minimum":0},"isNew":{"type":["boolean","null"]},"isLost":{"type":["boolean","null"]},"linksCount":{"type":["integer","null"],"minimum":0},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["fromUrl","toUrl","anchor","dofollow","rank","spamScore","firstSeenAt","lastSeenAt","isNew","isLost","linksCount","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"grouping":{"type":"string","const":"provider_unique_referring_page"},"status":{"type":"string","const":"live"},"requestedLimit":{"type":"integer","minimum":1},"providerTotalCount":{"type":["integer","null"],"minimum":0}},"required":["sourceProduct","sourceKind","inputTarget","normalizedTarget","returnedCount","items","missing","truncated","grouping","status","requestedLimit","providerTotalCount"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-backlink-records","x-nexscope-mcp-tool-name":"nexscope_seo_backlink_records","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-backlink-anchors/run":{"post":{"tags":["Backlinks & Authority"],"summary":"seo-backlink-anchors","description":"Bounded anchors projection from the Nexscope backlink index. Preserve target kind and provider scope. Proprietary rankings are not Google ratings or measured traffic. No pagination or additional provider calls. Unapproved costs prevent execution.","operationId":"runSeoBacklinkAnchors","externalDocs":{"description":"seo-backlink-anchors documentation","url":"https://www.nexscope.ai/api-docs/seo-backlink-anchors"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["target"],"additionalProperties":false},"example":{"target":{"kind":"DOMAIN","target":" Example.COM. "},"limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"sourceProduct":{"type":"string","const":"backlinks"},"sourceKind":{"type":"string","const":"dataforseo_backlink_index"},"inputTarget":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"normalizedTarget":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"anchor":{"type":"string"},"rank":{"type":["integer","null"],"minimum":0,"maximum":1000},"backlinks":{"type":["integer","null"],"minimum":0},"referringDomains":{"type":["integer","null"],"minimum":0},"referringMainDomains":{"type":["integer","null"],"minimum":0},"backlinksSpamScore":{"type":["integer","null"],"minimum":0,"maximum":100},"firstSeenAt":{"type":["integer","null"],"minimum":0},"lostAt":{"type":["integer","null"],"minimum":0},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["anchor","rank","backlinks","referringDomains","referringMainDomains","backlinksSpamScore","firstSeenAt","lostAt","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"sourceScope":{"type":"string","const":"provider_default"},"requestedLimit":{"type":"integer","minimum":1},"providerTotalCount":{"type":["integer","null"],"minimum":0}},"required":["sourceProduct","sourceKind","inputTarget","normalizedTarget","returnedCount","items","missing","truncated","sourceScope","requestedLimit","providerTotalCount"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-backlink-anchors","x-nexscope-mcp-tool-name":"nexscope_seo_backlink_anchors","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-domain-backlink-pages/run":{"post":{"tags":["Backlinks & Authority"],"summary":"seo-domain-backlink-pages","description":"Bounded domain pages projection from the Nexscope backlink index. Preserve target kind and provider scope. Proprietary rankings are not Google ratings or measured traffic. No pagination or additional provider calls. Unapproved costs prevent execution.","operationId":"runSeoDomainBacklinkPages","externalDocs":{"description":"seo-domain-backlink-pages documentation","url":"https://www.nexscope.ai/api-docs/seo-domain-backlink-pages"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"string","minLength":1,"maxLength":254},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["target"],"additionalProperties":false},"example":{"target":" Example.COM. ","limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"sourceProduct":{"type":"string","const":"backlinks"},"sourceKind":{"type":"string","const":"dataforseo_backlink_index"},"inputTarget":{"type":"string"},"normalizedTarget":{"type":"string"},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":["string","null"]},"httpStatus":{"type":["integer","null"],"minimum":100,"maximum":599},"lastCrawledAt":{"type":["integer","null"],"minimum":0},"backlinks":{"type":["integer","null"],"minimum":0},"rank":{"type":["integer","null"],"minimum":0,"maximum":1000},"referringDomains":{"type":["integer","null"],"minimum":0},"pageSpamScore":{"type":["integer","null"],"minimum":0,"maximum":100},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["url","title","httpStatus","lastCrawledAt","backlinks","rank","referringDomains","pageSpamScore","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"sourceScope":{"type":"string","const":"provider_default"},"requestedLimit":{"type":"integer","minimum":1},"providerTotalCount":{"type":["integer","null"],"minimum":0}},"required":["sourceProduct","sourceKind","inputTarget","normalizedTarget","returnedCount","items","missing","truncated","sourceScope","requestedLimit","providerTotalCount"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-domain-backlink-pages","x-nexscope-mcp-tool-name":"nexscope_seo_domain_backlink_pages","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-page-backlink-composition/run":{"post":{"tags":["Backlinks & Authority"],"summary":"Page Backlink Composition","description":"Bounded domain and page rank values from the Nexscope backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.","operationId":"runSeoPageBacklinkComposition","externalDocs":{"description":"Page Backlink Composition documentation","url":"https://www.nexscope.ai/api-docs/seo-page-backlink-composition"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"string","minLength":1,"maxLength":2048,"format":"uri"}},"required":["page"],"additionalProperties":false},"example":{"page":"HTTPS://www.example.com:443/A?b=2&a=1"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"sourceProduct":{"type":"string","const":"backlinks"},"sourceKind":{"type":"string","const":"dataforseo_backlink_index"},"inputTarget":{"type":"string"},"normalizedTarget":{"type":"string"},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"rank":{"type":["integer","null"],"minimum":0,"maximum":1000},"backlinks":{"type":["integer","null"],"minimum":0},"backlinksSpamScore":{"type":["integer","null"],"minimum":0,"maximum":100},"firstSeenAt":{"type":["integer","null"],"minimum":0},"lostAt":{"type":["integer","null"],"minimum":0},"composition":{"type":"object","properties":{"brokenBacklinks":{"type":["integer","null"],"minimum":0},"brokenPages":{"type":["integer","null"],"minimum":0},"referringDomains":{"type":["integer","null"],"minimum":0},"referringMainDomains":{"type":["integer","null"],"minimum":0},"referringPages":{"type":["integer","null"],"minimum":0},"referringIps":{"type":["integer","null"],"minimum":0},"referringSubnets":{"type":["integer","null"],"minimum":0},"referringPagesNofollow":{"type":["integer","null"],"minimum":0},"linkTypes":{"type":"object","properties":{"anchor":{"type":["integer","null"],"minimum":0},"image":{"type":["integer","null"],"minimum":0},"link":{"type":["integer","null"],"minimum":0},"meta":{"type":["integer","null"],"minimum":0},"canonical":{"type":["integer","null"],"minimum":0},"alternate":{"type":["integer","null"],"minimum":0},"redirect":{"type":["integer","null"],"minimum":0}},"required":["anchor","image","link","meta","canonical","alternate","redirect"],"additionalProperties":false}},"required":["brokenBacklinks","brokenPages","referringDomains","referringMainDomains","referringPages","referringIps","referringSubnets","referringPagesNofollow","linkTypes"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["url","rank","backlinks","backlinksSpamScore","firstSeenAt","lostAt","composition","missing"],"additionalProperties":false},"minItems":0,"maxItems":1},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"}},"required":["sourceProduct","sourceKind","inputTarget","normalizedTarget","returnedCount","items","missing","truncated"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-page-backlink-composition","x-nexscope-mcp-tool-name":"nexscope_seo_page_backlink_composition","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-referring-domains/run":{"post":{"tags":["Backlinks & Authority"],"summary":"seo-referring-domains","description":"Bounded referring domains projection from the Nexscope backlink index. Preserve target kind and provider scope. Proprietary rankings are not Google ratings or measured traffic. No pagination or additional provider calls. Unapproved costs prevent execution.","operationId":"runSeoReferringDomains","externalDocs":{"description":"seo-referring-domains documentation","url":"https://www.nexscope.ai/api-docs/seo-referring-domains"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["target"],"additionalProperties":false},"example":{"target":{"kind":"DOMAIN","target":" Example.COM. "},"limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"sourceProduct":{"type":"string","const":"backlinks"},"sourceKind":{"type":"string","const":"dataforseo_backlink_index"},"inputTarget":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"normalizedTarget":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"rank":{"type":["integer","null"],"minimum":0,"maximum":1000},"backlinks":{"type":["integer","null"],"minimum":0},"referringPages":{"type":["integer","null"],"minimum":0},"firstSeenAt":{"type":["integer","null"],"minimum":0},"lostAt":{"type":["integer","null"],"minimum":0},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["domain","rank","backlinks","referringPages","firstSeenAt","lostAt","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"sourceScope":{"type":"string","const":"provider_default"},"requestedLimit":{"type":"integer","minimum":1},"providerTotalCount":{"type":["integer","null"],"minimum":0}},"required":["sourceProduct","sourceKind","inputTarget","normalizedTarget","returnedCount","items","missing","truncated","sourceScope","requestedLimit","providerTotalCount"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-referring-domains","x-nexscope-mcp-tool-name":"nexscope_seo_referring_domains","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-referring-networks/run":{"post":{"tags":["Backlinks & Authority"],"summary":"seo-referring-networks","description":"Bounded referring networks projection from the Nexscope backlink index. Preserve target kind and provider scope. Proprietary rankings are not Google ratings or measured traffic. No pagination or additional provider calls. Unapproved costs prevent execution.","operationId":"runSeoReferringNetworks","externalDocs":{"description":"seo-referring-networks documentation","url":"https://www.nexscope.ai/api-docs/seo-referring-networks"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10},"networkType":{"type":"string","enum":["IP","SUBNET"],"default":"IP"}},"required":["target"],"additionalProperties":false},"example":{"limit":2,"networkType":"IP","target":{"kind":"DOMAIN","target":" Example.COM. "}}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"sourceProduct":{"type":"string","const":"backlinks"},"sourceKind":{"type":"string","const":"dataforseo_backlink_index"},"inputTarget":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"normalizedTarget":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"networkAddress":{"type":"string"},"rank":{"type":["integer","null"],"minimum":0,"maximum":1000},"backlinks":{"type":["integer","null"],"minimum":0},"referringDomains":{"type":["integer","null"],"minimum":0},"referringPages":{"type":["integer","null"],"minimum":0},"firstSeenAt":{"type":["integer","null"],"minimum":0},"networkType":{"type":"string","enum":["IP","SUBNET"]},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["networkAddress","rank","backlinks","referringDomains","referringPages","firstSeenAt","networkType","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"sourceScope":{"type":"string","const":"provider_default"},"requestedLimit":{"type":"integer","minimum":1},"providerTotalCount":{"type":["integer","null"],"minimum":0},"networkType":{"type":"string","enum":["IP","SUBNET"]}},"required":["sourceProduct","sourceKind","inputTarget","normalizedTarget","returnedCount","items","missing","truncated","sourceScope","requestedLimit","providerTotalCount","networkType"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-referring-networks","x-nexscope-mcp-tool-name":"nexscope_seo_referring_networks","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-backlink-competitors/run":{"post":{"tags":["Backlinks & Authority"],"summary":"seo-backlink-competitors","description":"Bounded competitors projection from the Nexscope backlink index. Preserve target kind and provider scope. Proprietary rankings are not Google ratings or measured traffic. No pagination or additional provider calls. Unapproved costs prevent execution.","operationId":"runSeoBacklinkCompetitors","externalDocs":{"description":"seo-backlink-competitors documentation","url":"https://www.nexscope.ai/api-docs/seo-backlink-competitors"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"string","minLength":1,"maxLength":254},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["target"],"additionalProperties":false},"example":{"target":" Example.COM. ","limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"sourceProduct":{"type":"string","const":"backlinks"},"sourceKind":{"type":"string","const":"dataforseo_backlink_index"},"inputTarget":{"type":"string"},"normalizedTarget":{"type":"string"},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"rank":{"type":["integer","null"],"minimum":0,"maximum":1000},"intersections":{"type":["integer","null"],"minimum":0},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["domain","rank","intersections","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"excludedLargeDomains":{"type":"boolean","const":true},"competitionBasis":{"type":"string","const":"shared_backlink_profile"},"requestedLimit":{"type":"integer","minimum":1},"providerTotalCount":{"type":["integer","null"],"minimum":0}},"required":["sourceProduct","sourceKind","inputTarget","normalizedTarget","returnedCount","items","missing","truncated","excludedLargeDomains","competitionBasis","requestedLimit","providerTotalCount"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-backlink-competitors","x-nexscope-mcp-tool-name":"nexscope_seo_backlink_competitors","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-backlink-domain-intersection/run":{"post":{"tags":["Backlinks & Authority"],"summary":"seo-backlink-domain-intersection","description":"Bounded domain and page rank values from the Nexscope backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.","operationId":"runSeoBacklinkDomainIntersection","externalDocs":{"description":"seo-backlink-domain-intersection documentation","url":"https://www.nexscope.ai/api-docs/seo-backlink-domain-intersection"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target1":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"target2":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["target1","target2"],"additionalProperties":false},"example":{"target2":{"kind":"PAGE","target":"https://second.example/page"},"target1":{"kind":"DOMAIN","target":" Example.COM. "},"limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"sourceProduct":{"type":"string","const":"backlinks"},"sourceKind":{"type":"string","const":"dataforseo_backlink_index"},"inputTarget1":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"inputTarget2":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"normalizedTarget1":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"normalizedTarget2":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"requestedLimit":{"type":"integer","minimum":1},"providerTotalCount":{"type":["integer","null"],"minimum":0},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"referringDomain":{"type":"string"},"first":{"type":"object","properties":{"rank":{"type":["integer","null"],"minimum":0,"maximum":1000},"backlinks":{"type":["integer","null"],"minimum":0}},"required":["rank","backlinks"],"additionalProperties":false},"second":{"type":"object","properties":{"rank":{"type":["integer","null"],"minimum":0,"maximum":1000},"backlinks":{"type":["integer","null"],"minimum":0}},"required":["rank","backlinks"],"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["referringDomain","first","second","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"}},"required":["sourceProduct","sourceKind","inputTarget1","inputTarget2","normalizedTarget1","normalizedTarget2","requestedLimit","providerTotalCount","returnedCount","items","missing","truncated"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-backlink-domain-intersection","x-nexscope-mcp-tool-name":"nexscope_seo_backlink_domain_intersection","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-backlink-page-intersection/run":{"post":{"tags":["Backlinks & Authority"],"summary":"seo-backlink-page-intersection","description":"Bounded domain and page rank values from the Nexscope backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.","operationId":"runSeoBacklinkPageIntersection","externalDocs":{"description":"seo-backlink-page-intersection documentation","url":"https://www.nexscope.ai/api-docs/seo-backlink-page-intersection"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target1":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"target2":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["target1","target2"],"additionalProperties":false},"example":{"target2":{"kind":"PAGE","target":"https://second.example/page"},"target1":{"kind":"DOMAIN","target":" Example.COM. "},"limit":2}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"sourceProduct":{"type":"string","const":"backlinks"},"sourceKind":{"type":"string","const":"dataforseo_backlink_index"},"inputTarget1":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"inputTarget2":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"normalizedTarget1":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"normalizedTarget2":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"requestedLimit":{"type":"integer","minimum":1},"providerTotalCount":{"type":["integer","null"],"minimum":0},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"referringPage":{"type":"string"},"first":{"type":"array","items":{"type":"object","properties":{"fromUrl":{"type":"string"},"toUrl":{"type":"string"},"anchor":{"type":["string","null"]},"dofollow":{"type":["boolean","null"]},"rank":{"type":["integer","null"],"minimum":0,"maximum":1000},"spamScore":{"type":["integer","null"],"minimum":0,"maximum":100},"firstSeenAt":{"type":["integer","null"],"minimum":0},"lastSeenAt":{"type":["integer","null"],"minimum":0},"isNew":{"type":["boolean","null"]},"isLost":{"type":["boolean","null"]},"linksCount":{"type":["integer","null"],"minimum":0},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["fromUrl","toUrl","anchor","dofollow","rank","spamScore","firstSeenAt","lastSeenAt","isNew","isLost","linksCount","missing"],"additionalProperties":false},"minItems":1,"maxItems":5},"second":{"type":"array","items":{"type":"object","properties":{"fromUrl":{"type":"string"},"toUrl":{"type":"string"},"anchor":{"type":["string","null"]},"dofollow":{"type":["boolean","null"]},"rank":{"type":["integer","null"],"minimum":0,"maximum":1000},"spamScore":{"type":["integer","null"],"minimum":0,"maximum":100},"firstSeenAt":{"type":["integer","null"],"minimum":0},"lastSeenAt":{"type":["integer","null"],"minimum":0},"isNew":{"type":["boolean","null"]},"isLost":{"type":["boolean","null"]},"linksCount":{"type":["integer","null"],"minimum":0},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["fromUrl","toUrl","anchor","dofollow","rank","spamScore","firstSeenAt","lastSeenAt","isNew","isLost","linksCount","missing"],"additionalProperties":false},"minItems":1,"maxItems":5},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["referringPage","first","second","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"}},"required":["sourceProduct","sourceKind","inputTarget1","inputTarget2","normalizedTarget1","normalizedTarget2","requestedLimit","providerTotalCount","returnedCount","items","missing","truncated"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-backlink-page-intersection","x-nexscope-mcp-tool-name":"nexscope_seo_backlink_page_intersection","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-backlink-timeseries/run":{"post":{"tags":["Backlinks & Authority"],"summary":"seo-backlink-timeseries","description":"Bounded calendar history values from the Nexscope backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.","operationId":"runSeoBacklinkTimeseries","externalDocs":{"description":"seo-backlink-timeseries documentation","url":"https://www.nexscope.ai/api-docs/seo-backlink-timeseries"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"string","minLength":1,"maxLength":254},"dateFrom":{"type":"string","format":"date"},"dateTo":{"type":"string","format":"date"},"groupRange":{"type":"string","enum":["DAY","WEEK","MONTH","YEAR"],"default":"MONTH"}},"required":["target","dateFrom","dateTo"],"additionalProperties":false},"example":{"dateTo":"2026-05-13","target":"example.com","dateFrom":"2026-03-23","groupRange":"MONTH"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"sourceProduct":{"type":"string","const":"backlinks"},"sourceKind":{"type":"string","const":"dataforseo_backlink_index"},"inputTarget":{"type":"string"},"normalizedTarget":{"type":"string"},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"bucketEndAt":{"type":"integer","minimum":0},"rank":{"type":["integer","null"],"minimum":0,"maximum":1000},"backlinks":{"type":["integer","null"],"minimum":0},"backlinksNofollow":{"type":["integer","null"],"minimum":0},"referringDomains":{"type":["integer","null"],"minimum":0},"referringMainDomains":{"type":["integer","null"],"minimum":0},"referringPages":{"type":["integer","null"],"minimum":0},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["bucketEndAt","rank","backlinks","backlinksNofollow","referringDomains","referringMainDomains","referringPages","missing"],"additionalProperties":false},"minItems":0,"maxItems":366},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"requestedDateFrom":{"type":"string","format":"date"},"requestedDateTo":{"type":"string","format":"date"},"groupRange":{"type":"string","enum":["DAY","WEEK","MONTH","YEAR"]},"bucketPolicy":{"type":"string","const":"provider_full_period"},"zeroMeaning":{"type":"string","const":"provider_zero_or_no_data"}},"required":["sourceProduct","sourceKind","inputTarget","normalizedTarget","returnedCount","items","missing","truncated","requestedDateFrom","requestedDateTo","groupRange","bucketPolicy","zeroMeaning"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-backlink-timeseries","x-nexscope-mcp-tool-name":"nexscope_seo_backlink_timeseries","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-backlink-new-lost/run":{"post":{"tags":["Backlinks & Authority"],"summary":"seo-backlink-new-lost","description":"Bounded calendar history values from the Nexscope backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.","operationId":"runSeoBacklinkNewLost","externalDocs":{"description":"seo-backlink-new-lost documentation","url":"https://www.nexscope.ai/api-docs/seo-backlink-new-lost"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"string","minLength":1,"maxLength":254},"dateFrom":{"type":"string","format":"date"},"dateTo":{"type":"string","format":"date"},"groupRange":{"type":"string","enum":["DAY","WEEK","MONTH","YEAR"],"default":"MONTH"}},"required":["target","dateFrom","dateTo"],"additionalProperties":false},"example":{"dateTo":"2026-05-13","target":"example.com","dateFrom":"2026-03-23","groupRange":"MONTH"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"sourceProduct":{"type":"string","const":"backlinks"},"sourceKind":{"type":"string","const":"dataforseo_backlink_index"},"inputTarget":{"type":"string"},"normalizedTarget":{"type":"string"},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"bucketEndAt":{"type":"integer","minimum":0},"newBacklinks":{"type":["integer","null"],"minimum":0},"lostBacklinks":{"type":["integer","null"],"minimum":0},"newReferringDomains":{"type":["integer","null"],"minimum":0},"lostReferringDomains":{"type":["integer","null"],"minimum":0},"newReferringMainDomains":{"type":["integer","null"],"minimum":0},"lostReferringMainDomains":{"type":["integer","null"],"minimum":0},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["bucketEndAt","newBacklinks","lostBacklinks","newReferringDomains","lostReferringDomains","newReferringMainDomains","lostReferringMainDomains","missing"],"additionalProperties":false},"minItems":0,"maxItems":366},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"},"requestedDateFrom":{"type":"string","format":"date"},"requestedDateTo":{"type":"string","format":"date"},"groupRange":{"type":"string","enum":["DAY","WEEK","MONTH","YEAR"]},"bucketPolicy":{"type":"string","const":"provider_full_period"},"zeroMeaning":{"type":"string","const":"provider_zero_or_no_data"}},"required":["sourceProduct","sourceKind","inputTarget","normalizedTarget","returnedCount","items","missing","truncated","requestedDateFrom","requestedDateTo","groupRange","bucketPolicy","zeroMeaning"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-backlink-new-lost","x-nexscope-mcp-tool-name":"nexscope_seo_backlink_new_lost","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-backlink-authority-ranks/run":{"post":{"tags":["Backlinks & Authority"],"summary":"Nexscope Authority Ranks","description":"Bounded domain and page rank values from the Nexscope backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.","operationId":"runSeoBacklinkAuthorityRanks","externalDocs":{"description":"Nexscope Authority Ranks documentation","url":"https://www.nexscope.ai/api-docs/seo-backlink-authority-ranks"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"targets":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"minItems":1,"maxItems":20}},"required":["targets"],"additionalProperties":false},"example":{"targets":[{"kind":"DOMAIN","target":" Example.COM. "},{"kind":"DOMAIN","target":"example.com"},{"kind":"PAGE","target":"HTTPS://www.example.com:443/A?b=2&a=1"}]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"sourceProduct":{"type":"string","const":"backlinks"},"sourceKind":{"type":"string","const":"dataforseo_backlink_index"},"inputTargets":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"minItems":1,"maxItems":20},"normalizedTargets":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"minItems":1,"maxItems":20},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"target":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"rank":{"type":["integer","null"],"minimum":0,"maximum":1000},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["target","rank","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"}},"required":["sourceProduct","sourceKind","inputTargets","normalizedTargets","returnedCount","items","missing","truncated"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-backlink-authority-ranks","x-nexscope-mcp-tool-name":"nexscope_seo_backlink_authority_ranks","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-backlink-spam-scores/run":{"post":{"tags":["Backlinks & Authority"],"summary":"Target Spam Scores","description":"Bounded domain and page targetSpamScore values from the Nexscope backlink index. Independently callable bulk interface sharing source facts with backlink overview. No new independent authority fact is claimed. Unknown costs remain unapproved. No pagination or extra lookup.","operationId":"runSeoBacklinkSpamScores","externalDocs":{"description":"Target Spam Scores documentation","url":"https://www.nexscope.ai/api-docs/seo-backlink-spam-scores"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"targets":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"minItems":1,"maxItems":20}},"required":["targets"],"additionalProperties":false},"example":{"targets":[{"kind":"DOMAIN","target":" Example.COM. "},{"kind":"DOMAIN","target":"example.com"},{"kind":"PAGE","target":"HTTPS://www.example.com:443/A?b=2&a=1"}]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"sourceProduct":{"type":"string","const":"backlinks"},"sourceKind":{"type":"string","const":"dataforseo_backlink_index"},"inputTargets":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"minItems":1,"maxItems":20},"normalizedTargets":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"minItems":1,"maxItems":20},"returnedCount":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","properties":{"target":{"type":"object","properties":{"kind":{"type":"string","enum":["DOMAIN","PAGE"]},"target":{"type":"string","minLength":1,"maxLength":2048}},"required":["kind","target"],"additionalProperties":false},"targetSpamScore":{"type":["integer","null"],"minimum":0,"maximum":100},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0}},"required":["target","targetSpamScore","missing"],"additionalProperties":false},"minItems":0,"maxItems":20},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"reason":{"type":"string","enum":["UPSTREAM_FIELD_MISSING","UPSTREAM_FIELD_INVALID","DUPLICATE_UPSTREAM_ITEM","UPSTREAM_ITEM_MISSING"]}},"required":["field","reason"],"additionalProperties":false},"minItems":0},"truncated":{"type":"boolean"}},"required":["sourceProduct","sourceKind","inputTargets","normalizedTargets","returnedCount","items","missing","truncated"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-backlink-spam-scores","x-nexscope-mcp-tool-name":"nexscope_seo_backlink_spam_scores","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-paid-keywords/run":{"post":{"tags":["Advertising Intelligence"],"summary":"seo-paid-keywords","description":"Provider database paid keyword ranks with source measurement times. Nullable fields preserve missing evidence. Provider observations and estimates do not establish actual account performance. No additional calls or fallback.","operationId":"runSeoPaidKeywords","externalDocs":{"description":"seo-paid-keywords documentation","url":"https://www.nexscope.ai/api-docs/seo-paid-keywords"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"string","minLength":1,"maxLength":254},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20}},"required":["target"],"additionalProperties":false},"example":{"target":" Example.COM ","limit":100}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"meta":{"type":"object","properties":{"source":{"type":"string","const":"DATAFORSEO_LABS_PAID_RANKING"},"sampledAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"retrievedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"market":{"type":"object","properties":{"country":{"type":"string","const":"US"},"locationCode":{"type":"integer","const":2840},"language":{"type":["string","null"],"enum":["en",null]}},"required":["country","locationCode","language"],"additionalProperties":false},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"reason":{"type":"string","enum":["MISSING","NULL","INVALID","UNSUPPORTED","TRUNCATED"]}},"required":["path","reason"],"additionalProperties":false},"minItems":0,"maxItems":100},"missingOverflow":{"type":"boolean"}},"required":["source","sampledAt","retrievedAt","market","truncated","missing","missingOverflow"],"additionalProperties":false},"target":{"type":"string"},"keywords":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":["string","null"]},"searchVolume":{"type":["integer","null"],"minimum":0},"cpc":{"type":["number","null"],"minimum":0,"description":"Provider USD CPC estimate, not account actual CPC."},"rankGroup":{"type":["integer","null"],"minimum":0},"rankAbsolute":{"type":["integer","null"],"minimum":0},"url":{"type":["string","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"measuredAt":{"type":["integer","null"],"minimum":0}},"required":["keyword","searchVolume","cpc","rankGroup","rankAbsolute","url","title","description","measuredAt"],"additionalProperties":false},"minItems":0,"maxItems":100}},"required":["meta","target","keywords"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-paid-keywords","x-nexscope-mcp-tool-name":"nexscope_seo_paid_keywords","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-search-ad-samples/run":{"post":{"tags":["Advertising Intelligence"],"summary":"seo-search-ad-samples","description":"Single page US desktop paid search ad samples; ordinary punctuation preserved. Nullable fields preserve missing evidence. Provider observations and estimates do not establish actual account performance. No additional calls or fallback.","operationId":"runSeoSearchAdSamples","externalDocs":{"description":"seo-search-ad-samples documentation","url":"https://www.nexscope.ai/api-docs/seo-search-ad-samples"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"maxLength":200},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["keyword"],"additionalProperties":false},"example":{"keyword":" C++ ","limit":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"meta":{"type":"object","properties":{"source":{"type":"string","const":"DATAFORSEO_GOOGLE_SERP_PAID_SAMPLE"},"sampledAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"retrievedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"market":{"type":"object","properties":{"country":{"type":"string","const":"US"},"locationCode":{"type":"integer","const":2840},"language":{"type":["string","null"],"enum":["en",null]}},"required":["country","locationCode","language"],"additionalProperties":false},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"reason":{"type":"string","enum":["MISSING","NULL","INVALID","UNSUPPORTED","TRUNCATED"]}},"required":["path","reason"],"additionalProperties":false},"minItems":0,"maxItems":100},"missingOverflow":{"type":"boolean"}},"required":["source","sampledAt","retrievedAt","market","truncated","missing","missingOverflow"],"additionalProperties":false},"keyword":{"type":"string"},"ads":{"type":"array","items":{"type":"object","properties":{"title":{"type":["string","null"]},"description":{"type":["string","null"]},"url":{"type":["string","null"]},"domain":{"type":["string","null"]},"rankGroup":{"type":["integer","null"],"minimum":0},"rankAbsolute":{"type":["integer","null"],"minimum":0},"page":{"type":["integer","null"],"minimum":0}},"required":["title","description","url","domain","rankGroup","rankAbsolute","page"],"additionalProperties":false},"minItems":0,"maxItems":20}},"required":["meta","keyword","ads"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-search-ad-samples","x-nexscope-mcp-tool-name":"nexscope_seo_search_ad_samples","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-advertiser-search/run":{"post":{"tags":["Advertising Intelligence"],"summary":"seo-advertiser-search","description":"Single advertiser directory matches, with approximate ad counts. Nullable fields preserve missing evidence. Provider observations and estimates do not establish actual account performance. No additional calls or fallback.","operationId":"runSeoAdvertiserSearch","externalDocs":{"description":"seo-advertiser-search documentation","url":"https://www.nexscope.ai/api-docs/seo-advertiser-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":200},"limit":{"type":"integer","minimum":1,"maximum":20,"default":20}},"required":["query"],"additionalProperties":false},"example":{"query":"Acme","limit":1}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"meta":{"type":"object","properties":{"source":{"type":"string","const":"DATAFORSEO_GOOGLE_ADVERTISER_DIRECTORY"},"sampledAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"retrievedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"market":{"type":"object","properties":{"country":{"type":"string","const":"US"},"locationCode":{"type":"integer","const":2840},"language":{"type":["string","null"],"enum":["en",null]}},"required":["country","locationCode","language"],"additionalProperties":false},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"reason":{"type":"string","enum":["MISSING","NULL","INVALID","UNSUPPORTED","TRUNCATED"]}},"required":["path","reason"],"additionalProperties":false},"minItems":0,"maxItems":100},"missingOverflow":{"type":"boolean"}},"required":["source","sampledAt","retrievedAt","market","truncated","missing","missingOverflow"],"additionalProperties":false},"query":{"type":"string"},"advertisers":{"type":"array","items":{"type":"object","properties":{"advertiserId":{"type":["string","null"]},"name":{"type":["string","null"]},"location":{"type":["string","null"]},"verified":{"type":["boolean","null"]},"approxAdsCount":{"type":["integer","null"],"minimum":0},"rankGroup":{"type":["integer","null"],"minimum":0},"rankAbsolute":{"type":["integer","null"],"minimum":0}},"required":["advertiserId","name","location","verified","approxAdsCount","rankGroup","rankAbsolute"],"additionalProperties":false},"minItems":0,"maxItems":20}},"required":["meta","query","advertisers"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-advertiser-search","x-nexscope-mcp-tool-name":"nexscope_seo_advertiser_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-ad-transparency-search/run":{"post":{"tags":["Advertising Intelligence"],"summary":"seo-ad-transparency-search","description":"Google Search transparency records over the provider default history. Nullable fields preserve missing evidence. Provider observations and estimates do not establish actual account performance. No additional calls or fallback.","operationId":"runSeoAdTransparencySearch","externalDocs":{"description":"seo-ad-transparency-search documentation","url":"https://www.nexscope.ai/api-docs/seo-ad-transparency-search"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"string","minLength":1,"maxLength":254},"limit":{"type":"integer","minimum":1,"maximum":40,"default":20}},"required":["target"],"additionalProperties":false},"example":{"target":"example.com","limit":20}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"meta":{"type":"object","properties":{"source":{"type":"string","const":"DATAFORSEO_GOOGLE_AD_TRANSPARENCY"},"sampledAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"retrievedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"market":{"type":"object","properties":{"country":{"type":"string","const":"US"},"locationCode":{"type":"integer","const":2840},"language":{"type":["string","null"],"enum":["en",null]}},"required":["country","locationCode","language"],"additionalProperties":false},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"reason":{"type":"string","enum":["MISSING","NULL","INVALID","UNSUPPORTED","TRUNCATED"]}},"required":["path","reason"],"additionalProperties":false},"minItems":0,"maxItems":100},"missingOverflow":{"type":"boolean"},"historyRange":{"type":"string","const":"PROVIDER_DEFAULT_HISTORY"}},"required":["source","sampledAt","retrievedAt","market","truncated","missing","missingOverflow","historyRange"],"additionalProperties":false},"target":{"type":"string"},"creatives":{"type":"array","items":{"type":"object","properties":{"advertiserId":{"type":["string","null"]},"creativeId":{"type":["string","null"]},"advertiserName":{"type":["string","null"]},"recordUrl":{"type":["string","null"]},"verified":{"type":["boolean","null"]},"format":{"type":"string","enum":["TEXT","IMAGE","VIDEO","UNKNOWN"]},"firstShownAt":{"type":["integer","null"],"minimum":0},"lastShownAt":{"type":["integer","null"],"minimum":0},"previews":{"type":"array","items":{"type":"object","properties":{"url":{"type":["string","null"]},"width":{"type":["integer","null"],"minimum":0},"height":{"type":["integer","null"],"minimum":0}},"required":["url","width","height"],"additionalProperties":false},"minItems":0,"maxItems":5}},"required":["advertiserId","creativeId","advertiserName","recordUrl","verified","format","firstShownAt","lastShownAt","previews"],"additionalProperties":false},"minItems":0,"maxItems":40}},"required":["meta","target","creatives"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-ad-transparency-search","x-nexscope-mcp-tool-name":"nexscope_seo_ad_transparency_search","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-keyword-ad-traffic-forecast/run":{"post":{"tags":["Advertising Intelligence"],"summary":"seo-keyword-ad-traffic-forecast","description":"Google Ads keyword click, CPC and advertising spend forecasts over a frozen future date range. Nullable fields preserve missing evidence. Provider observations and estimates do not establish actual account performance. No additional calls or fallback.","operationId":"runSeoKeywordAdTrafficForecast","externalDocs":{"description":"seo-keyword-ad-traffic-forecast documentation","url":"https://www.nexscope.ai/api-docs/seo-keyword-ad-traffic-forecast"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keywords":{"type":"array","items":{"type":"string","minLength":1,"maxLength":80},"minItems":1,"maxItems":20},"bidUsd":{"type":"integer","minimum":1,"maximum":100},"match":{"type":"string","enum":["EXACT","PHRASE","BROAD"],"default":"EXACT"},"dateFrom":{"type":"string","format":"date"},"dateTo":{"type":"string","format":"date"}},"required":["keywords","bidUsd","dateFrom","dateTo"],"additionalProperties":false},"example":{"dateTo":"2026-10-02","keywords":[" Shoes ","BOOTS"],"bidUsd":1,"dateFrom":"2026-10-01"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"meta":{"type":"object","properties":{"source":{"type":"string","const":"DATAFORSEO_GOOGLE_ADS_FORECAST"},"sampledAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"retrievedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"market":{"type":"object","properties":{"country":{"type":"string","const":"US"},"locationCode":{"type":"integer","const":2840},"language":{"type":["string","null"],"enum":["en",null]}},"required":["country","locationCode","language"],"additionalProperties":false},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"reason":{"type":"string","enum":["MISSING","NULL","INVALID","UNSUPPORTED","TRUNCATED"]}},"required":["path","reason"],"additionalProperties":false},"minItems":0,"maxItems":100},"missingOverflow":{"type":"boolean"}},"required":["source","sampledAt","retrievedAt","market","truncated","missing","missingOverflow"],"additionalProperties":false},"keywords":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":["string","null"]},"expectedClicks":{"type":["number","null"],"minimum":0},"averageCpcUsd":{"type":["number","null"],"minimum":0},"projectedSpendUsd":{"type":["number","null"],"minimum":0}},"required":["keyword","expectedClicks","averageCpcUsd","projectedSpendUsd"],"additionalProperties":false},"minItems":1,"maxItems":20},"dateFrom":{"type":"string","format":"date"},"dateTo":{"type":"string","format":"date"},"bidUsd":{"type":"integer","minimum":1,"maximum":100},"match":{"type":"string","enum":["EXACT","PHRASE","BROAD"]},"currency":{"type":"string","const":"USD"}},"required":["meta","keywords","dateFrom","dateTo","bidUsd","match","currency"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-keyword-ad-traffic-forecast","x-nexscope-mcp-tool-name":"nexscope_seo_keyword_ad_traffic_forecast","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/seo-ad-audience-estimate/run":{"post":{"tags":["Advertising Intelligence"],"summary":"seo-ad-audience-estimate","description":"Bing monthly aggregate audience ranges under a separate daily advertising budget. Nullable fields preserve missing evidence. Provider observations and estimates do not establish actual account performance. No additional calls or fallback.","operationId":"runSeoAdAudienceEstimate","externalDocs":{"description":"seo-ad-audience-estimate documentation","url":"https://www.nexscope.ai/api-docs/seo-ad-audience-estimate"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ageBands":{"type":"array","items":{"type":"string","enum":["A18_24","A25_34","A35_49","A50_64","A65_PLUS"]},"minItems":1,"maxItems":5,"uniqueItems":true},"gender":{"type":"string","enum":["MALE","FEMALE","UNKNOWN"]},"bidUsd":{"type":"number","minimum":0.01,"maximum":100,"multipleOf":0.01},"dailyBudgetUsd":{"type":"number","minimum":1,"maximum":1000,"multipleOf":0.01}},"required":["ageBands","gender","bidUsd","dailyBudgetUsd"],"additionalProperties":false},"example":{"bidUsd":0.01,"gender":"UNKNOWN","dailyBudgetUsd":1,"ageBands":["A65_PLUS","A18_24"]}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"oneOf":[{"required":["callId","status","result"],"type":"object","properties":{"result":{"anyOf":[{"type":"object","properties":{"meta":{"type":"object","properties":{"source":{"type":"string","const":"DATAFORSEO_BING_AUDIENCE_ESTIMATE"},"sampledAt":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"retrievedAt":{"type":"integer","minimum":0,"maximum":9007199254740991},"market":{"type":"object","properties":{"country":{"type":"string","const":"US"},"locationCode":{"type":"integer","const":2840},"language":{"type":["string","null"],"enum":["en",null]}},"required":["country","locationCode","language"],"additionalProperties":false},"truncated":{"type":"boolean"},"missing":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"reason":{"type":"string","enum":["MISSING","NULL","INVALID","UNSUPPORTED","TRUNCATED"]}},"required":["path","reason"],"additionalProperties":false},"minItems":0,"maxItems":100},"missingOverflow":{"type":"boolean"}},"required":["source","sampledAt","retrievedAt","market","truncated","missing","missingOverflow"],"additionalProperties":false},"ageBands":{"type":"array","items":{"type":"string","enum":["A18_24","A25_34","A35_49","A50_64","A65_PLUS"]},"minItems":1,"maxItems":5},"gender":{"type":"string","enum":["MALE","FEMALE","UNKNOWN"]},"bidUsd":{"type":"number","minimum":0.01,"maximum":100},"dailyBudgetUsd":{"type":"number","minimum":1,"maximum":1000},"currency":{"type":["string","null"],"enum":["USD",null]},"period":{"type":"string","const":"MONTHLY"},"impressions":{"type":["object","null"],"properties":{"low":{"type":["integer","null"],"minimum":0},"high":{"type":["integer","null"],"minimum":0}},"required":["low","high"],"additionalProperties":false},"audienceSize":{"type":["object","null"],"properties":{"low":{"type":["integer","null"],"minimum":0},"high":{"type":["integer","null"],"minimum":0}},"required":["low","high"],"additionalProperties":false},"clicks":{"type":["object","null"],"properties":{"low":{"type":["integer","null"],"minimum":0},"high":{"type":["integer","null"],"minimum":0}},"required":["low","high"],"additionalProperties":false},"spend":{"type":["object","null"],"properties":{"low":{"type":["number","null"],"minimum":0},"high":{"type":["number","null"],"minimum":0}},"required":["low","high"],"additionalProperties":false},"costPerEvent":{"type":["object","null"],"properties":{"low":{"type":["number","null"],"minimum":0},"high":{"type":["number","null"],"minimum":0}},"required":["low","high"],"additionalProperties":false},"suggestedBid":{"type":["number","null"],"minimum":0},"suggestedDailyBudget":{"type":["number","null"],"minimum":0},"reachAudienceSize":{"type":["integer","null"],"minimum":0},"reachImpressions":{"type":["integer","null"],"minimum":0}},"required":["meta","ageBands","gender","bidUsd","dailyBudgetUsd","currency","period","impressions","audienceSize","clicks","spend","costPerEvent","suggestedBid","suggestedDailyBudget","reachAudienceSize","reachImpressions"],"additionalProperties":false},{"type":"null"}]},"callId":{"type":"string"},"schemaVersion":{"type":"string"},"status":{"type":"string"},"source":{"type":"string"},"requestedAt":{"type":["string","integer","null"]},"completedAt":{"type":["string","integer","null"]},"coverage":{"type":["object","null"]},"usage":{"type":["object","null"],"properties":{"billingStatus":{"type":["string","null"]},"chargedCredits":{"type":["string","integer","null"]}},"additionalProperties":false}}},{"not":{"required":["result"]},"properties":{"reason":{"type":"string"},"taskId":{"type":["string","null"]},"retryable":{"type":"boolean"},"status":{"type":"string"},"callId":{"type":["string","null"]}},"type":"object","required":["callId","status","reason","retryable"]}]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"reason":"IN_PROGRESS","retryable":false,"status":"PROCESSING","callId":"00000000-0000-4000-8000-000000000001"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"seo-ad-audience-estimate","x-nexscope-mcp-tool-name":"nexscope_seo_ad_audience_estimate","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/gpt-image-2-5-generation/run":{"post":{"tags":["Image Generation Models"],"summary":"GPT Image 2.5 Sunburst","description":"Create and edit ecommerce visuals with precise instruction following, broad visual-style support, world-knowledge grounding, and reliable text rendering through the GPT Image 2.5 Sunburst route. The model is fixed by this API, so provider must not be supplied in the request.","operationId":"runGptImage25Generation","externalDocs":{"description":"GPT Image 2.5 Sunburst documentation","url":"https://www.nexscope.ai/api-docs/gpt-image-2-5-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Create and edit ecommerce visuals with precise instruction following, broad visual-style support, world-knowledge grounding, and reliable text rendering through the GPT Image 2.5 Sunburst route.","properties":{"imageUrls":{"type":"array","items":{"type":"string"},"description":"Optional public reference image URLs. Omit this field for text-to-image generation, or provide references for image-to-image generation. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.","example":[],"minItems":0,"maxItems":10},"prompt":{"type":"string","description":"Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.","example":"Keep the product consistent and generate a clean white-background ecommerce hero image.","maxLength":5000},"outputNum":{"type":"integer","description":"Number of images to generate. Valid range: 1 to 10; defaults to 1.","example":1,"minimum":1,"maximum":10},"resolution":{"type":"string","description":"Output resolution. Supported values: 1K, 2K, or 4K; defaults to 2K.","example":"2K","enum":["1K","2K","4K"]},"aspectRatio":{"type":"string","description":"Output aspect ratio. Supported values: 1:1, 3:4, 4:3, 2:3, 3:2, 9:16, 16:9, 4:5, 5:4, 21:9, 9:21.","example":"1:1","enum":["1:1","3:4","4:3","2:3","3:2","9:16","16:9","4:5","5:4","21:9","9:21"]},"quality":{"type":"string","description":"GPT Image quality. Supported values: low, medium, high, xhigh, max. Defaults to medium.","example":"medium","enum":["low","medium","high","xhigh","max"]}},"required":["prompt"],"example":{"imageUrls":[],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"2K","aspectRatio":"1:1","quality":"medium"},"additionalProperties":true},"example":{"imageUrls":[],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"2K","aspectRatio":"1:1","quality":"medium"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"gpt-image-2-5-generation","x-nexscope-mcp-tool-name":"nexscope_gpt_image_2_5_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/skills/gpt-image-2-5-flare-generation/run":{"post":{"tags":["Image Generation Models"],"summary":"GPT Image 2.5 Flare","description":"Create and edit ecommerce visuals with detailed instruction following, flexible visual styles, world-knowledge grounding, and dependable text rendering through the GPT Image 2.5 Flare route. The model is fixed by this API, so provider must not be supplied in the request.","operationId":"runGptImage25FlareGeneration","externalDocs":{"description":"GPT Image 2.5 Flare documentation","url":"https://www.nexscope.ai/api-docs/gpt-image-2-5-flare-generation"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Create and edit ecommerce visuals with detailed instruction following, flexible visual styles, world-knowledge grounding, and dependable text rendering through the GPT Image 2.5 Flare route.","properties":{"imageUrls":{"type":"array","items":{"type":"string"},"description":"Optional public reference image URLs. Omit this field for text-to-image generation, or provide references for image-to-image generation. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.","example":[],"minItems":0,"maxItems":10},"prompt":{"type":"string","description":"Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.","example":"Keep the product consistent and generate a clean white-background ecommerce hero image.","maxLength":5000},"outputNum":{"type":"integer","description":"Number of images to generate. Valid range: 1 to 10; defaults to 1.","example":1,"minimum":1,"maximum":10},"resolution":{"type":"string","description":"Output resolution. Supported values: 1K, 2K, or 4K; defaults to 2K.","example":"2K","enum":["1K","2K","4K"]},"aspectRatio":{"type":"string","description":"Output aspect ratio. Supported values: 1:1, 3:4, 4:3, 2:3, 3:2, 9:16, 16:9, 4:5, 5:4, 21:9, 9:21.","example":"1:1","enum":["1:1","3:4","4:3","2:3","3:2","9:16","16:9","4:5","5:4","21:9","9:21"]},"quality":{"type":"string","description":"GPT Image quality. Supported values: low, medium, high, xhigh, max. Defaults to medium.","example":"medium","enum":["low","medium","high","xhigh","max"]}},"required":["prompt"],"example":{"imageUrls":[],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"2K","aspectRatio":"1:1","quality":"medium"},"additionalProperties":true},"example":{"imageUrls":[],"prompt":"Keep the product consistent and generate a clean white-background ecommerce hero image.","outputNum":1,"resolution":"2K","aspectRatio":"1:1","quality":"medium"}}}},"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"result":{"anyOf":[{"description":"Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.","type":"object","additionalProperties":true},{"type":"null"}]},"status":{"enum":["PENDING","RUNNING","SUCCEEDED","FAILED","TIMEOUT"],"type":"string"},"taskId":{"type":"string"}},"type":"object","required":["taskId","status","result"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"taskId":"example-task","status":"PENDING","result":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"x-nexscope-slug":"gpt-image-2-5-flare-generation","x-nexscope-mcp-tool-name":"nexscope_gpt_image_2_5_flare_generation","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-catalog-derived":true,"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/api/skill-api/v1/mcp":{"get":{"summary":"Get MCP tool metadata, optionally by category","operationId":"getSkillApiMcpManifest","security":[],"responses":{"200":{"description":"Metadata only. Read code for success or a category validation error; execution authentication and billing are unchanged.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"tools":{"items":{"properties":{"description":{"type":"string"},"name":{"type":"string"},"outputSchema":{"type":"object"},"inputSchema":{"type":"object"}},"type":"object","required":["name","description","inputSchema","outputSchema"]},"type":"array"}},"type":"object","required":["tools"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}}}}}},"parameters":[{"description":"Optional category slug for tool metadata. Does not scope the MCP connection or change authentication, execution, or billing.","in":"query","name":"category","required":false,"schema":{"type":"string"}}]}},"/api/skill-api/v1/skills/{slug}/tasks/{taskId}":{"get":{"summary":"Query an existing asynchronous task using its originating skill","operationId":"getSkillApiTaskResult","responses":{"200":{"description":"Read code and data.status. Acceptance or a running task is not completion; the public data shape depends on the originating media or SEO API.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object"},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}},"parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}},{"in":"path","name":"taskId","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/SkillApiHttpStatus"}]}},"/alibaba1688/productDetail":{"post":{"operationId":"data_alibaba1688_product_detail_public","summary":"1688 Sourcing: product Detail API","description":"1688 Sourcing: product Detail API. Retail prices apply to one piece only when present; missing retailPrice must not be inferred from wholesale prices. CNY and foreignCurrency values differ. Confirm actual prices with order preview.","x-nexscope-slug":"data-alibaba1688-product-detail","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"offerId":{"type":"string","description":"1688 product ID in positive integer format; strings must be used to avoid loss of precision in large numbers; maximum length 1000","pattern":"^[1-9][0-9]*$","maxLength":1000},"country":{"type":"string","description":"Upstream compatibility field; usually omitted for this skill","default":"en"},"currency":{"type":"string","description":"Three-letter currency code, such as `USD`, `HKD`; the server will convert it to uppercase; the maximum length is 3","pattern":"^[A-Za-z]{3}$","maxLength":3}},"required":["offerId"],"additionalProperties":true},"example":{"offerId":"1234567890123456789","currency":"USD"}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"properties":{"data":{"anyOf":[{"type":"object","properties":{"offerId":{"anyOf":[{"type":"string","description":"1688 Product ID"},{"type":"null"}]},"subject":{"anyOf":[{"type":"string","description":"Chinese title"},{"type":"null"}]},"subjectTrans":{"anyOf":[{"type":"string","description":"Upstream extension header field, may be empty or the same as `subject`"},{"type":"null"}]},"description":{"anyOf":[{"type":"string","description":"Product details in Chinese, often containing HTML"},{"type":"null"}]},"descriptionTrans":{"anyOf":[{"type":"string","description":"Upstream extension details field, may be missing"},{"type":"null"}]},"categoryId":{"anyOf":[{"type":"string","description":"Current category ID"},{"type":"null"}]},"topCategoryId":{"anyOf":[{"type":"string","description":"First level category ID"},{"type":"null"}]},"secondCategoryId":{"anyOf":[{"type":"string","description":"Secondary category ID"},{"type":"null"}]},"thirdCategoryId":{"anyOf":[{"type":"string","description":"Third-level category ID"},{"type":"null"}]},"categoryName":{"anyOf":[{"type":"string","description":"Category name, may be missing"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","description":"Product status"},{"type":"null"}]},"createDate":{"anyOf":[{"type":"string","description":"Product creation time"},{"type":"null"}]},"productUrl":{"anyOf":[{"type":"string","description":"1688 product promotion link"},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Data source, currently `1688`"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Result style, currently `productDetail`"},{"type":"null"}]},"productImage":{"anyOf":[{"type":"object","properties":{"images":{"type":"array","items":{"type":"string","description":""}},"whiteImage":{"type":"string","description":""}},"required":[],"additionalProperties":true},{"type":"null"}]},"productImageTrans":{"anyOf":[{"type":"object","properties":{"images":{"type":"array","items":{"type":"string","description":""}},"whiteImage":{"type":"string","description":""}},"required":[],"additionalProperties":true},{"type":"null"}]},"mainVideo":{"anyOf":[{"type":"string","description":"Main video address"},{"type":"null"}]},"detailVideo":{"anyOf":[{"type":"string","description":"Detailed video address"},{"type":"null"}]},"productAttributes":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"attributeId":{"type":"string","description":""},"attributeName":{"type":"string","description":""},"attributeNameTrans":{"type":"string","description":""},"value":{"type":"string","description":""},"valueTrans":{"type":"string","description":""}},"required":[],"additionalProperties":true}},{"type":"null"}]},"sellingPoints":{"anyOf":[{"type":"array","description":"Product selling point, may be empty","items":{}},{"type":"null"}]},"skuList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"skuId":{"type":"string","description":"SKU ID"},"specId":{"type":"string","description":"Specification ID"},"cargoNumber":{"type":"string","description":"SKU item number"},"amountOnSale":{"type":"integer","description":"Available inventory"},"price":{"type":"string","description":"SKU price (RMB); in the new retail price model, it is the wholesale price when the purchase quantity is greater than or equal to 2 pieces. The semantics of the old product model are combined with ladder and order preview judgments."},"retailPrice":{"type":"string","description":"SKU retail price (RMB), applicable to purchase quantity 1 piece; missing if the upstream does not have a retail price"},"foreignCurrencyRetailPrice":{"type":"number","description":"SKU retail price in foreign currency, applicable to purchase quantity 1 piece; missing when no currency requested, no retail price, or conversion failure"},"promotionPrice":{"type":"string","description":"marketing price"},"consignPrice":{"type":"string","description":"Dropshipping price; the upstream obsolete compatibility field may be missing"},"attributes":{"type":"array","items":{"type":"object","properties":{"attributeId":{"type":"string","description":""},"attributeName":{"type":"string","description":""},"value":{"type":"string","description":""},"skuImageUrl":{"type":"string","description":""}},"required":[],"additionalProperties":true}},"fenxiaoPriceInfo":{"type":"object","properties":{"offerPrice":{"type":"string","description":"CNY price, preserved as a decimal string."},"onePiecePrice":{"type":"string","description":"CNY price, preserved as a decimal string."},"foreignCurrencyPrice":{"type":"number","description":"Foreign currency value."},"foreignCurrencyPromotionPrice":{"type":"number","description":"Foreign currency value."}},"required":[],"additionalProperties":true}},"required":[],"additionalProperties":true}},{"type":"null"}]},"saleInfo":{"anyOf":[{"type":"object","properties":{"amountOnSale":{"type":"integer","description":"Total merchandise inventory"},"retailPrice":{"type":"string","description":"Product-level retail price (RMB), applicable to the purchase quantity of 1 piece; missing if the upstream does not have a retail price"},"foreignCurrencyRetailPrice":{"type":"number","description":"Item-level retail price in foreign currency, applicable to purchase quantity 1 piece; missing when no currency requested, no retail price, or conversion failure"},"quoteType":{"type":"integer","description":"`0` has no SKU and is based on product quantity; `1` is based on SKU specifications; `2` has SKU and is based on product quantity"},"priceRanges":{"type":"array","items":{"type":"object","properties":{"startQuantity":{"type":"integer","description":""},"price":{"type":"string","description":"Wholesale tier price in CNY, preserved as a decimal string."},"promotionPrice":{"type":"number","description":"Tier price; foreignCurrency fields use requested currency, other prices use CNY."},"foreignCurrencyPrice":{"type":"number","description":"Tier price; foreignCurrency fields use requested currency, other prices use CNY."},"foreignCurrencyPromotionPrice":{"type":"number","description":"Tier price; foreignCurrency fields use requested currency, other prices use CNY."}},"required":[],"additionalProperties":true}},"unitInfo":{"type":"object","properties":{"unit":{"type":"string","description":""},"transUnit":{"type":"string","description":""}},"required":[],"additionalProperties":true},"fenxiaoSaleInfo":{"type":"object","properties":{"startQuantity":{"type":"integer","description":""},"offerPrice":{"type":"number","description":""},"onePiecePrice":{"type":"number","description":""},"onePieceFreePostage":{"type":"boolean","description":""}},"required":[],"additionalProperties":true}},"required":[],"additionalProperties":true},{"type":"null"}]},"shippingInfo":{"anyOf":[{"type":"object","properties":{"sendGoodsAddressText":{"type":"string","description":"Place of shipment"},"shippingTimeGuarantee":{"type":"string","description":"Delivery guarantee"},"weight":{"type":"number","description":"Product weight, unit kg"},"officialWeight":{"type":"number","description":"Official measured weight in kg"},"pkgSizeSource":{"type":"string","description":"Product weight data source"},"skuShippingInfoList":{"type":"array","items":{"type":"object","properties":{"skuId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"specId":{"type":"string","description":""},"weight":{"type":"number","description":"Weight in grams."},"officialWeight":{"type":"number","description":"Kilograms."},"aiWeight":{"type":"number","description":"Kilograms."},"length":{"type":"number","description":"Centimeters."},"width":{"type":"number","description":"Centimeters."},"height":{"type":"number","description":"Centimeters."}},"required":[],"additionalProperties":true}},"skuShippingDetails":{"type":"array","items":{"type":"object","properties":{"skuId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"specId":{"type":"string","description":""},"weight":{"type":"number","description":"Weight in kilograms."},"officialWeight":{"type":"number","description":"Kilograms."},"aiWeight":{"type":"number","description":"Kilograms."},"length":{"type":"number","description":"Centimeters."},"width":{"type":"number","description":"Centimeters."},"height":{"type":"number","description":"Centimeters."}},"required":[],"additionalProperties":true}}},"required":[],"additionalProperties":true},{"type":"null"}]},"companyName":{"anyOf":[{"type":"string","description":"Supplier/Store Name"},{"type":"null"}]},"sellerOpenId":{"anyOf":[{"type":"string","description":"Merchant Encrypted ID"},{"type":"null"}]},"sellerDataInfo":{"anyOf":[{"type":"object","properties":{"tradeMedalLevel":{"type":"string","description":"Seller Trading Medal"},"compositeServiceScore":{"type":"string","description":"Comprehensive service points"},"logisticsExperienceScore":{"type":"string","description":"Logistics experience points"},"disputeComplaintScore":{"type":"string","description":"Dispute resolution points"},"offerExperienceScore":{"type":"string","description":"Product experience points"},"consultingExperienceScore":{"type":"string","description":"Consulting experience points"},"afterSalesExperienceScore":{"type":"string","description":"Return or exchange experience points"},"repeatPurchasePercent":{"type":"string","description":"Seller return rate"},"collect30DayWithin48HPercent":{"type":"string","description":"Collection rate in the last 30 days and 48 hours"},"qualityRefundWithin30Day":{"type":"string","description":"Quality refund rate in the last 30 days"}},"required":[],"additionalProperties":true},{"type":"null"}]},"sellerMixSetting":{"anyOf":[{"type":"object","properties":{"generalHunpi":{"type":"boolean","description":""},"mixAmount":{"type":"number","description":""},"mixNumber":{"type":"integer","description":""}},"required":[],"additionalProperties":true},{"type":"null"}]},"channelPrice":{"anyOf":[{"type":"object","properties":{"skuPrices":{"type":"array","items":{"type":"object","properties":{"skuId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"currentPrice":{"type":"number","description":""}},"required":[],"additionalProperties":true}}},"required":[],"additionalProperties":true},{"type":"null"}]},"promotion":{"anyOf":[{"type":"object","properties":{"hasPromotion":{"type":"boolean","description":""},"promotionType":{"type":"string","description":""}},"required":[],"additionalProperties":true},{"type":"null"}]},"minOrderQuantity":{"anyOf":[{"type":"integer","description":"Minimum minimum quantity"},{"type":"null"}]},"batchNumber":{"anyOf":[{"type":"integer","description":"One lot quantity"},{"type":"null"}]},"productCargoNumber":{"anyOf":[{"type":"string","description":"Product number"},{"type":"null"}]},"soldOut":{"anyOf":[{"type":"string","description":"Product sales"},{"type":"null"}]},"isJxhy":{"anyOf":[{"type":"boolean","description":"Whether to select supply sources"},{"type":"null"}]},"isSelect":{"anyOf":[{"type":"boolean","description":"Whether to cross-border Select pallet"},{"type":"null"}]},"tradeScore":{"anyOf":[{"type":"string","description":"Product Transaction Rating"},{"type":"null"}]},"offerIdentities":{"anyOf":[{"type":"array","description":"Product or merchant identification","items":{}},{"type":"null"}]},"tags":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","description":""},"value":{"type":"boolean","description":"Whether the product has this tag."}},"required":[],"additionalProperties":true}},{"type":"null"}]},"certificates":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"certificateName":{"type":"string","description":""},"certificateCode":{"type":"string","description":""},"certificatePhotoList":{"type":"array","items":{"type":"string","description":""}}},"required":[],"additionalProperties":true}},{"type":"null"}]},"invoiceInfo":{"anyOf":[{"type":"object","properties":{"supportOnlineInvoice":{"type":"boolean","description":""},"supportFastInvoice":{"type":"boolean","description":""},"invoiceTypes":{"type":"array","items":{"type":"string","description":""}},"taxpayerType":{"type":"string","description":""}},"required":[],"additionalProperties":true},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"type":"integer","description":"0 means accepted or successful; nonzero is a platform error."},"msg":{"type":["string","null"]},"ts":{"type":"string","description":"Epoch milliseconds."},"time":{"type":"string","description":"Server local time: yyyy-MM-dd HH:mm:ss."},"cost":{"type":"string","description":"Elapsed milliseconds, never credits; -1 outside web requests."},"traceId":{"type":["string","null"]}},"required":["code","msg","data","ts","time","cost","traceId"],"type":"object"},"example":{"data":{"offerId":"1234567890123456789","subject":"Example product","skuList":[{"skuId":"456789012345678901","specId":"example-spec","retailPrice":"4.80","price":"4.20","amountOnSale":100,"fenxiaoPriceInfo":{"offerPrice":"4.20","onePiecePrice":"4.80"}}],"saleInfo":{"retailPrice":"4.80","priceRanges":[{"startQuantity":2,"price":"4.20"}]},"tags":[{"key":"isSelect","value":true}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-alibaba1688-product-detail/run":{"post":{"operationId":"data_alibaba1688_product_detail_run","summary":"1688 Sourcing: product Detail API","description":"1688 Sourcing: product Detail API. Retail prices apply to one piece only when present; missing retailPrice must not be inferred from wholesale prices. CNY and foreignCurrency values differ. Confirm actual prices with order preview.","x-nexscope-slug":"data-alibaba1688-product-detail","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"offerId":{"type":"string","description":"1688 product ID in positive integer format; strings must be used to avoid loss of precision in large numbers; maximum length 1000","pattern":"^[1-9][0-9]*$","maxLength":1000},"country":{"type":"string","description":"Upstream compatibility field; usually omitted for this skill","default":"en"},"currency":{"type":"string","description":"Three-letter currency code, such as `USD`, `HKD`; the server will convert it to uppercase; the maximum length is 3","pattern":"^[A-Za-z]{3}$","maxLength":3}},"required":["offerId"],"additionalProperties":true},"example":{"offerId":"1234567890123456789","currency":"USD"}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"properties":{"data":{"anyOf":[{"type":"object","properties":{"offerId":{"anyOf":[{"type":"string","description":"1688 Product ID"},{"type":"null"}]},"subject":{"anyOf":[{"type":"string","description":"Chinese title"},{"type":"null"}]},"subjectTrans":{"anyOf":[{"type":"string","description":"Upstream extension header field, may be empty or the same as `subject`"},{"type":"null"}]},"description":{"anyOf":[{"type":"string","description":"Product details in Chinese, often containing HTML"},{"type":"null"}]},"descriptionTrans":{"anyOf":[{"type":"string","description":"Upstream extension details field, may be missing"},{"type":"null"}]},"categoryId":{"anyOf":[{"type":"string","description":"Current category ID"},{"type":"null"}]},"topCategoryId":{"anyOf":[{"type":"string","description":"First level category ID"},{"type":"null"}]},"secondCategoryId":{"anyOf":[{"type":"string","description":"Secondary category ID"},{"type":"null"}]},"thirdCategoryId":{"anyOf":[{"type":"string","description":"Third-level category ID"},{"type":"null"}]},"categoryName":{"anyOf":[{"type":"string","description":"Category name, may be missing"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","description":"Product status"},{"type":"null"}]},"createDate":{"anyOf":[{"type":"string","description":"Product creation time"},{"type":"null"}]},"productUrl":{"anyOf":[{"type":"string","description":"1688 product promotion link"},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Data source, currently `1688`"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Result style, currently `productDetail`"},{"type":"null"}]},"productImage":{"anyOf":[{"type":"object","properties":{"images":{"type":"array","items":{"type":"string","description":""}},"whiteImage":{"type":"string","description":""}},"required":[],"additionalProperties":true},{"type":"null"}]},"productImageTrans":{"anyOf":[{"type":"object","properties":{"images":{"type":"array","items":{"type":"string","description":""}},"whiteImage":{"type":"string","description":""}},"required":[],"additionalProperties":true},{"type":"null"}]},"mainVideo":{"anyOf":[{"type":"string","description":"Main video address"},{"type":"null"}]},"detailVideo":{"anyOf":[{"type":"string","description":"Detailed video address"},{"type":"null"}]},"productAttributes":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"attributeId":{"type":"string","description":""},"attributeName":{"type":"string","description":""},"attributeNameTrans":{"type":"string","description":""},"value":{"type":"string","description":""},"valueTrans":{"type":"string","description":""}},"required":[],"additionalProperties":true}},{"type":"null"}]},"sellingPoints":{"anyOf":[{"type":"array","description":"Product selling point, may be empty","items":{}},{"type":"null"}]},"skuList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"skuId":{"type":"string","description":"SKU ID"},"specId":{"type":"string","description":"Specification ID"},"cargoNumber":{"type":"string","description":"SKU item number"},"amountOnSale":{"type":"integer","description":"Available inventory"},"price":{"type":"string","description":"SKU price (RMB); in the new retail price model, it is the wholesale price when the purchase quantity is greater than or equal to 2 pieces. The semantics of the old product model are combined with ladder and order preview judgments."},"retailPrice":{"type":"string","description":"SKU retail price (RMB), applicable to purchase quantity 1 piece; missing if the upstream does not have a retail price"},"foreignCurrencyRetailPrice":{"type":"number","description":"SKU retail price in foreign currency, applicable to purchase quantity 1 piece; missing when no currency requested, no retail price, or conversion failure"},"promotionPrice":{"type":"string","description":"marketing price"},"consignPrice":{"type":"string","description":"Dropshipping price; the upstream obsolete compatibility field may be missing"},"attributes":{"type":"array","items":{"type":"object","properties":{"attributeId":{"type":"string","description":""},"attributeName":{"type":"string","description":""},"value":{"type":"string","description":""},"skuImageUrl":{"type":"string","description":""}},"required":[],"additionalProperties":true}},"fenxiaoPriceInfo":{"type":"object","properties":{"offerPrice":{"type":"string","description":"CNY price, preserved as a decimal string."},"onePiecePrice":{"type":"string","description":"CNY price, preserved as a decimal string."},"foreignCurrencyPrice":{"type":"number","description":"Foreign currency value."},"foreignCurrencyPromotionPrice":{"type":"number","description":"Foreign currency value."}},"required":[],"additionalProperties":true}},"required":[],"additionalProperties":true}},{"type":"null"}]},"saleInfo":{"anyOf":[{"type":"object","properties":{"amountOnSale":{"type":"integer","description":"Total merchandise inventory"},"retailPrice":{"type":"string","description":"Product-level retail price (RMB), applicable to the purchase quantity of 1 piece; missing if the upstream does not have a retail price"},"foreignCurrencyRetailPrice":{"type":"number","description":"Item-level retail price in foreign currency, applicable to purchase quantity 1 piece; missing when no currency requested, no retail price, or conversion failure"},"quoteType":{"type":"integer","description":"`0` has no SKU and is based on product quantity; `1` is based on SKU specifications; `2` has SKU and is based on product quantity"},"priceRanges":{"type":"array","items":{"type":"object","properties":{"startQuantity":{"type":"integer","description":""},"price":{"type":"string","description":"Wholesale tier price in CNY, preserved as a decimal string."},"promotionPrice":{"type":"number","description":"Tier price; foreignCurrency fields use requested currency, other prices use CNY."},"foreignCurrencyPrice":{"type":"number","description":"Tier price; foreignCurrency fields use requested currency, other prices use CNY."},"foreignCurrencyPromotionPrice":{"type":"number","description":"Tier price; foreignCurrency fields use requested currency, other prices use CNY."}},"required":[],"additionalProperties":true}},"unitInfo":{"type":"object","properties":{"unit":{"type":"string","description":""},"transUnit":{"type":"string","description":""}},"required":[],"additionalProperties":true},"fenxiaoSaleInfo":{"type":"object","properties":{"startQuantity":{"type":"integer","description":""},"offerPrice":{"type":"number","description":""},"onePiecePrice":{"type":"number","description":""},"onePieceFreePostage":{"type":"boolean","description":""}},"required":[],"additionalProperties":true}},"required":[],"additionalProperties":true},{"type":"null"}]},"shippingInfo":{"anyOf":[{"type":"object","properties":{"sendGoodsAddressText":{"type":"string","description":"Place of shipment"},"shippingTimeGuarantee":{"type":"string","description":"Delivery guarantee"},"weight":{"type":"number","description":"Product weight, unit kg"},"officialWeight":{"type":"number","description":"Official measured weight in kg"},"pkgSizeSource":{"type":"string","description":"Product weight data source"},"skuShippingInfoList":{"type":"array","items":{"type":"object","properties":{"skuId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"specId":{"type":"string","description":""},"weight":{"type":"number","description":"Weight in grams."},"officialWeight":{"type":"number","description":"Kilograms."},"aiWeight":{"type":"number","description":"Kilograms."},"length":{"type":"number","description":"Centimeters."},"width":{"type":"number","description":"Centimeters."},"height":{"type":"number","description":"Centimeters."}},"required":[],"additionalProperties":true}},"skuShippingDetails":{"type":"array","items":{"type":"object","properties":{"skuId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"specId":{"type":"string","description":""},"weight":{"type":"number","description":"Weight in kilograms."},"officialWeight":{"type":"number","description":"Kilograms."},"aiWeight":{"type":"number","description":"Kilograms."},"length":{"type":"number","description":"Centimeters."},"width":{"type":"number","description":"Centimeters."},"height":{"type":"number","description":"Centimeters."}},"required":[],"additionalProperties":true}}},"required":[],"additionalProperties":true},{"type":"null"}]},"companyName":{"anyOf":[{"type":"string","description":"Supplier/Store Name"},{"type":"null"}]},"sellerOpenId":{"anyOf":[{"type":"string","description":"Merchant Encrypted ID"},{"type":"null"}]},"sellerDataInfo":{"anyOf":[{"type":"object","properties":{"tradeMedalLevel":{"type":"string","description":"Seller Trading Medal"},"compositeServiceScore":{"type":"string","description":"Comprehensive service points"},"logisticsExperienceScore":{"type":"string","description":"Logistics experience points"},"disputeComplaintScore":{"type":"string","description":"Dispute resolution points"},"offerExperienceScore":{"type":"string","description":"Product experience points"},"consultingExperienceScore":{"type":"string","description":"Consulting experience points"},"afterSalesExperienceScore":{"type":"string","description":"Return or exchange experience points"},"repeatPurchasePercent":{"type":"string","description":"Seller return rate"},"collect30DayWithin48HPercent":{"type":"string","description":"Collection rate in the last 30 days and 48 hours"},"qualityRefundWithin30Day":{"type":"string","description":"Quality refund rate in the last 30 days"}},"required":[],"additionalProperties":true},{"type":"null"}]},"sellerMixSetting":{"anyOf":[{"type":"object","properties":{"generalHunpi":{"type":"boolean","description":""},"mixAmount":{"type":"number","description":""},"mixNumber":{"type":"integer","description":""}},"required":[],"additionalProperties":true},{"type":"null"}]},"channelPrice":{"anyOf":[{"type":"object","properties":{"skuPrices":{"type":"array","items":{"type":"object","properties":{"skuId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"currentPrice":{"type":"number","description":""}},"required":[],"additionalProperties":true}}},"required":[],"additionalProperties":true},{"type":"null"}]},"promotion":{"anyOf":[{"type":"object","properties":{"hasPromotion":{"type":"boolean","description":""},"promotionType":{"type":"string","description":""}},"required":[],"additionalProperties":true},{"type":"null"}]},"minOrderQuantity":{"anyOf":[{"type":"integer","description":"Minimum minimum quantity"},{"type":"null"}]},"batchNumber":{"anyOf":[{"type":"integer","description":"One lot quantity"},{"type":"null"}]},"productCargoNumber":{"anyOf":[{"type":"string","description":"Product number"},{"type":"null"}]},"soldOut":{"anyOf":[{"type":"string","description":"Product sales"},{"type":"null"}]},"isJxhy":{"anyOf":[{"type":"boolean","description":"Whether to select supply sources"},{"type":"null"}]},"isSelect":{"anyOf":[{"type":"boolean","description":"Whether to cross-border Select pallet"},{"type":"null"}]},"tradeScore":{"anyOf":[{"type":"string","description":"Product Transaction Rating"},{"type":"null"}]},"offerIdentities":{"anyOf":[{"type":"array","description":"Product or merchant identification","items":{}},{"type":"null"}]},"tags":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","description":""},"value":{"type":"boolean","description":"Whether the product has this tag."}},"required":[],"additionalProperties":true}},{"type":"null"}]},"certificates":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"certificateName":{"type":"string","description":""},"certificateCode":{"type":"string","description":""},"certificatePhotoList":{"type":"array","items":{"type":"string","description":""}}},"required":[],"additionalProperties":true}},{"type":"null"}]},"invoiceInfo":{"anyOf":[{"type":"object","properties":{"supportOnlineInvoice":{"type":"boolean","description":""},"supportFastInvoice":{"type":"boolean","description":""},"invoiceTypes":{"type":"array","items":{"type":"string","description":""}},"taxpayerType":{"type":"string","description":""}},"required":[],"additionalProperties":true},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"type":"integer","description":"0 means accepted or successful; nonzero is a platform error."},"msg":{"type":["string","null"]},"ts":{"type":"string","description":"Epoch milliseconds."},"time":{"type":"string","description":"Server local time: yyyy-MM-dd HH:mm:ss."},"cost":{"type":"string","description":"Elapsed milliseconds, never credits; -1 outside web requests."},"traceId":{"type":["string","null"]}},"required":["code","msg","data","ts","time","cost","traceId"],"type":"object"},"example":{"data":{"offerId":"1234567890123456789","subject":"Example product","skuList":[{"skuId":"456789012345678901","specId":"example-spec","retailPrice":"4.80","price":"4.20","amountOnSale":100,"fenxiaoPriceInfo":{"offerPrice":"4.20","onePiecePrice":"4.80"}}],"saleInfo":{"retailPrice":"4.80","priceRanges":[{"startQuantity":2,"price":"4.20"}]},"tags":[{"key":"isSelect","value":true}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/woocommerce/products":{"post":{"operationId":"woocommerce_products","tags":["WooCommerce"],"summary":"WooCommerce Products","description":"Search within one store, inspect a product, or retrieve a parent's SKUs using its public Store API. No store key or OAuth is required. Anonymous store pricing applies. Each request costs 10 credits. Failed requests are automatically refunded.","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"storeUrl":{"type":"string","description":"Public HTTPS store root or WordPress installation path, without query or fragment.","maxLength":2048},"keyword":{"type":"string","description":"Search only within this store; at most 200 characters.","maxLength":200},"pageNum":{"type":"integer","description":"Page number, default 1.","maximum":10000,"minimum":1},"pageSize":{"type":"integer","description":"Page size, default 20, maximum 100.","maximum":100,"minimum":1}},"type":"object","required":["storeUrl"]},"example":{"storeUrl":"https://example.com"}}}},"responses":{"200":{"description":"Inspect code: 0 means success. Each request costs 10 credits. Failed requests are automatically refunded.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"storeUrl":{"type":"string","description":"Normalized store identity.","example":"https://example.com"},"fetchedAt":{"type":"string","description":"Fetch time in epoch milliseconds, not the product modification time.","example":"1792972800000"},"cacheHit":{"type":"boolean","description":"Whether the response was served from the anonymous 60-second cache.","example":false},"products":{"type":"array","description":"Normalized public products.","example":[],"items":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"34"},{"type":"null"}]},"parentId":{"anyOf":[{"type":"string","description":"Store value; null when unavailable.","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Store value; null when unavailable.","example":"simple"},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"Cotton Shirt"},{"type":"null"}]},"sku":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"SHIRT-34"},{"type":"null"}]},"url":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"https://example.com/product/shirt"},{"type":"null"}]},"description":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"Cotton shirt."},{"type":"null"}]},"shortDescription":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"Cotton shirt."},{"type":"null"}]},"variation":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":""},{"type":"null"}]},"isInStock":{"anyOf":[{"type":"boolean","description":"Store value, null when unavailable.","example":true},{"type":"null"}]},"isPasswordProtected":{"anyOf":[{"type":"boolean","description":"Store value, null when unavailable.","example":false},{"type":"null"}]},"stockQuantity":{"anyOf":[{"type":"integer","description":"Always null: public Store API does not expose exact inventory.","example":null},{"type":"null"}]},"prices":{"type":"object","description":"Anonymous store pricing; decimal values are strings for exact precision.","example":{},"properties":{"currency":{"type":"string","description":"Currency code.","example":"USD"},"minorUnit":{"type":"integer","description":"Currency decimal precision.","example":2},"price":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":"11.05"},{"type":"null"}]},"regularPrice":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"salePrice":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"priceMinor":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"regularPriceMinor":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"salePriceMinor":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"minPriceMinor":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"maxPriceMinor":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"minPrice":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"maxPrice":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]}},"required":["currency","minorUnit"]},"images":{"type":"array","description":"Public image URLs; images are not fetched by this API.","example":[],"items":{"type":"object","properties":{"url":{"type":"string","description":"Image URL.","example":"https://example.com/image.jpg"},"alt":{"type":"string","description":"Plain text alternative label.","example":"Shirt"}},"required":["url","alt"]}}},"required":["prices","images"]}},"pageNum":{"type":"integer","description":"Pagination metadata; totals are null when the store omits headers.","example":1},"pageSize":{"type":"integer","description":"Pagination metadata; totals are null when the store omits headers.","example":20},"total":{"anyOf":[{"type":"integer","description":"Pagination metadata; totals are null when the store omits headers.","example":1},{"type":"null"}]},"totalPages":{"anyOf":[{"type":"integer","description":"Pagination metadata; totals are null when the store omits headers.","example":1},{"type":"null"}]},"hasMore":{"anyOf":[{"type":"boolean","description":"Null when total pages are unavailable.","example":false},{"type":"null"}]}},"required":["storeUrl","fetchedAt","cacheHit","products","pageNum","pageSize"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"storeUrl":"https://example.com","fetchedAt":1792972800000,"cacheHit":false,"products":[{"id":"34","type":"simple","name":"Cotton Shirt","sku":"SHIRT-34","url":"https://example.com/product/shirt","description":"Cotton shirt.","shortDescription":"Cotton shirt.","variation":"","isInStock":true,"isPasswordProtected":false,"prices":{"currency":"USD","minorUnit":2,"price":"11.05"},"images":[{"url":"https://example.com/image.jpg","alt":"Shirt"}]}],"pageNum":1,"pageSize":20,"total":1,"totalPages":1,"hasMore":false},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/woocommerce/productDetail":{"post":{"operationId":"woocommerce_product_detail","tags":["WooCommerce"],"summary":"WooCommerce Product Detail","description":"Search within one store, inspect a product, or retrieve a parent's SKUs using its public Store API. No store key or OAuth is required. Anonymous store pricing applies. Each request costs 10 credits. Failed requests are automatically refunded.","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"storeUrl":{"type":"string","description":"Public HTTPS store root or WordPress installation path, without query or fragment.","maxLength":2048},"productId":{"type":"string","description":"Store-scoped positive product ID, at most 19 decimal digits.","pattern":"^[1-9][0-9]{0,18}$"}},"type":"object","required":["storeUrl","productId"]},"example":{"storeUrl":"https://example.com","productId":"34"}}}},"responses":{"200":{"description":"Inspect code: 0 means success. Each request costs 10 credits. Failed requests are automatically refunded.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"storeUrl":{"type":"string","description":"Normalized store identity.","example":"https://example.com"},"fetchedAt":{"type":"string","description":"Fetch time in epoch milliseconds, not the product modification time.","example":"1792972800000"},"cacheHit":{"type":"boolean","description":"Whether the response was served from the anonymous 60-second cache.","example":false},"product":{"type":"object","description":"Normalized public products.","example":{},"properties":{"id":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"34"},{"type":"null"}]},"parentId":{"anyOf":[{"type":"string","description":"Store value; null when unavailable.","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Store value; null when unavailable.","example":"simple"},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"Cotton Shirt"},{"type":"null"}]},"sku":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"SHIRT-34"},{"type":"null"}]},"url":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"https://example.com/product/shirt"},{"type":"null"}]},"description":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"Cotton shirt."},{"type":"null"}]},"shortDescription":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"Cotton shirt."},{"type":"null"}]},"variation":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":""},{"type":"null"}]},"isInStock":{"anyOf":[{"type":"boolean","description":"Store value, null when unavailable.","example":true},{"type":"null"}]},"isPasswordProtected":{"anyOf":[{"type":"boolean","description":"Store value, null when unavailable.","example":false},{"type":"null"}]},"stockQuantity":{"anyOf":[{"type":"integer","description":"Always null: public Store API does not expose exact inventory.","example":null},{"type":"null"}]},"prices":{"type":"object","description":"Anonymous store pricing; decimal values are strings for exact precision.","example":{},"properties":{"currency":{"type":"string","description":"Currency code.","example":"USD"},"minorUnit":{"type":"integer","description":"Currency decimal precision.","example":2},"price":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":"11.05"},{"type":"null"}]},"regularPrice":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"salePrice":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"priceMinor":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"regularPriceMinor":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"salePriceMinor":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"minPriceMinor":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"maxPriceMinor":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"minPrice":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"maxPrice":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]}},"required":["currency","minorUnit"]},"images":{"type":"array","description":"Public image URLs; images are not fetched by this API.","example":[],"items":{"type":"object","properties":{"url":{"type":"string","description":"Image URL.","example":"https://example.com/image.jpg"},"alt":{"type":"string","description":"Plain text alternative label.","example":"Shirt"}},"required":["url","alt"]}}},"required":["prices","images"]}},"required":["storeUrl","fetchedAt","cacheHit","product"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"storeUrl":"https://example.com","fetchedAt":1792972800000,"cacheHit":false,"product":{"id":"34","type":"simple","name":"Cotton Shirt","sku":"SHIRT-34","url":"https://example.com/product/shirt","description":"Cotton shirt.","shortDescription":"Cotton shirt.","variation":"","isInStock":true,"isPasswordProtected":false,"prices":{"currency":"USD","minorUnit":2,"price":"11.05"},"images":[{"url":"https://example.com/image.jpg","alt":"Shirt"}]}},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/woocommerce/productVariations":{"post":{"operationId":"woocommerce_product_variations","tags":["WooCommerce"],"summary":"WooCommerce Product Variations","description":"Search within one store, inspect a product, or retrieve a parent's SKUs using its public Store API. No store key or OAuth is required. Anonymous store pricing applies. Each request costs 10 credits. Failed requests are automatically refunded.","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"storeUrl":{"type":"string","description":"Public HTTPS store root or WordPress installation path, without query or fragment.","maxLength":2048},"productId":{"type":"string","description":"Store-scoped positive product ID, at most 19 decimal digits.","pattern":"^[1-9][0-9]{0,18}$"},"pageNum":{"type":"integer","description":"Page number, default 1.","maximum":10000,"minimum":1},"pageSize":{"type":"integer","description":"Page size, default 20, maximum 100.","maximum":100,"minimum":1}},"type":"object","required":["storeUrl","productId"]},"example":{"storeUrl":"https://example.com","productId":"34"}}}},"responses":{"200":{"description":"Inspect code: 0 means success. Each request costs 10 credits. Failed requests are automatically refunded.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"storeUrl":{"type":"string","description":"Normalized store identity.","example":"https://example.com"},"fetchedAt":{"type":"string","description":"Fetch time in epoch milliseconds, not the product modification time.","example":"1792972800000"},"cacheHit":{"type":"boolean","description":"Whether the response was served from the anonymous 60-second cache.","example":false},"products":{"type":"array","description":"Normalized public products.","example":[],"items":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"34"},{"type":"null"}]},"parentId":{"anyOf":[{"type":"string","description":"Store value; null when unavailable.","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Store value; null when unavailable.","example":"simple"},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"Cotton Shirt"},{"type":"null"}]},"sku":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"SHIRT-34"},{"type":"null"}]},"url":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"https://example.com/product/shirt"},{"type":"null"}]},"description":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"Cotton shirt."},{"type":"null"}]},"shortDescription":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":"Cotton shirt."},{"type":"null"}]},"variation":{"anyOf":[{"type":"string","description":"Plain text or public product identifier.","example":""},{"type":"null"}]},"isInStock":{"anyOf":[{"type":"boolean","description":"Store value, null when unavailable.","example":true},{"type":"null"}]},"isPasswordProtected":{"anyOf":[{"type":"boolean","description":"Store value, null when unavailable.","example":false},{"type":"null"}]},"stockQuantity":{"anyOf":[{"type":"integer","description":"Always null: public Store API does not expose exact inventory.","example":null},{"type":"null"}]},"prices":{"type":"object","description":"Anonymous store pricing; decimal values are strings for exact precision.","example":{},"properties":{"currency":{"type":"string","description":"Currency code.","example":"USD"},"minorUnit":{"type":"integer","description":"Currency decimal precision.","example":2},"price":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":"11.05"},{"type":"null"}]},"regularPrice":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"salePrice":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"priceMinor":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"regularPriceMinor":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"salePriceMinor":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"minPriceMinor":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"maxPriceMinor":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"minPrice":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]},"maxPrice":{"anyOf":[{"type":"string","description":"Exact amount string; null when unavailable. Minor suffix denotes original smallest-unit amount.","example":null},{"type":"null"}]}},"required":["currency","minorUnit"]},"images":{"type":"array","description":"Public image URLs; images are not fetched by this API.","example":[],"items":{"type":"object","properties":{"url":{"type":"string","description":"Image URL.","example":"https://example.com/image.jpg"},"alt":{"type":"string","description":"Plain text alternative label.","example":"Shirt"}},"required":["url","alt"]}}},"required":["prices","images"]}},"pageNum":{"type":"integer","description":"Pagination metadata; totals are null when the store omits headers.","example":1},"pageSize":{"type":"integer","description":"Pagination metadata; totals are null when the store omits headers.","example":20},"total":{"anyOf":[{"type":"integer","description":"Pagination metadata; totals are null when the store omits headers.","example":1},{"type":"null"}]},"totalPages":{"anyOf":[{"type":"integer","description":"Pagination metadata; totals are null when the store omits headers.","example":1},{"type":"null"}]},"hasMore":{"anyOf":[{"type":"boolean","description":"Null when total pages are unavailable.","example":false},{"type":"null"}]},"parentId":{"type":"string","description":"Requested parent product ID; every SKU must match it.","example":"34"}},"required":["storeUrl","fetchedAt","cacheHit","products","pageNum","pageSize","parentId"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"storeUrl":"https://example.com","fetchedAt":1792972800000,"cacheHit":false,"products":[{"id":"34","type":"simple","name":"Cotton Shirt","sku":"SHIRT-34","url":"https://example.com/product/shirt","description":"Cotton shirt.","shortDescription":"Cotton shirt.","variation":"","isInStock":true,"isPasswordProtected":false,"prices":{"currency":"USD","minorUnit":2,"price":"11.05"},"images":[{"url":"https://example.com/image.jpg","alt":"Shirt"}]}],"pageNum":1,"pageSize":20,"total":1,"totalPages":1,"hasMore":false,"parentId":"34"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/woocommerce/productCategories":{"post":{"operationId":"woocommerce_product_categories","tags":["WooCommerce"],"summary":"WooCommerce Product Categories","description":"Anonymous read-only official Store API data. No merchant key or OAuth is required. Availability depends on the store version and configuration. Password-protected reviews remain hidden. Each request costs 10 credits. Failed requests are automatically refunded.","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["storeUrl"],"additionalProperties":false,"properties":{"storeUrl":{"type":"string","description":"Public HTTPS store root or WordPress installation path.","maxLength":2048},"pageNum":{"type":"integer","description":"Page number, default 1.","maximum":10000,"minimum":1},"pageSize":{"type":"integer","description":"Page size, default 20, maximum 100.","maximum":100,"minimum":1},"keyword":{"type":"string","description":"Search within this store; at most 200 characters.","maxLength":200},"hideEmpty":{"type":"boolean","description":"Hide terms without products; defaults to the store's true setting."}},"type":"object"},"example":{"storeUrl":"https://example.com"}}}},"responses":{"200":{"description":"Inspect code: 0 means success. Each request costs 10 credits. Failed requests are automatically refunded.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"storeUrl":{"type":"string","description":"Normalized store identity.","example":"https://example.com"},"fetchedAt":{"type":"string","description":"Fetch time in epoch milliseconds; preserved on cache hits.","example":"1792972800000"},"cacheHit":{"type":"boolean","description":"Whether the response was served from the anonymous 60-second cache.","example":false},"categories":{"type":"array","description":"Normalized public data. Missing optional values are null or empty strings.","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Store-scoped ID string.","example":"1"},"name":{"type":"string","description":"Plain text name.","example":"Color"},"slug":{"type":"string","description":"Plain text or public URL; empty when unavailable. Images are not fetched.","example":"blue"},"description":{"type":"string","description":"Plain text or public URL; empty when unavailable. Images are not fetched.","example":""},"imageUrl":{"type":"string","description":"Plain text or public URL; empty when unavailable. Images are not fetched.","example":""},"url":{"type":"string","description":"Plain text or public URL; empty when unavailable. Images are not fetched.","example":""},"parentId":{"anyOf":[{"type":"string","description":"Parent ID; 0 is a root term, null means unavailable.","example":"0"},{"type":"null"}]},"count":{"anyOf":[{"type":"integer","description":"Associated product count, null when unavailable.","example":1},{"type":"null"}]}},"required":["id","name","slug","description","imageUrl","url"]}},"pageNum":{"type":"integer","description":"Pagination metadata; omitted upstream totals become null.","example":1},"pageSize":{"type":"integer","description":"Pagination metadata; omitted upstream totals become null.","example":20},"total":{"anyOf":[{"type":"integer","description":"Pagination metadata; omitted upstream totals become null.","example":1},{"type":"null"}]},"totalPages":{"anyOf":[{"type":"integer","description":"Pagination metadata; omitted upstream totals become null.","example":1},{"type":"null"}]},"hasMore":{"anyOf":[{"type":"boolean","description":"Null when upstream total pages are unavailable.","example":false},{"type":"null"}]}},"required":["storeUrl","fetchedAt","cacheHit","categories","pageNum","pageSize"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"storeUrl":"https://example.com","fetchedAt":1792972800000,"cacheHit":false,"categories":[{"id":"1","name":"Color","slug":"blue","description":"","imageUrl":"","url":"","parentId":"0","count":1}],"pageNum":1,"pageSize":20,"total":1,"totalPages":1,"hasMore":false},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/woocommerce/productTags":{"post":{"operationId":"woocommerce_product_tags","tags":["WooCommerce"],"summary":"WooCommerce Product Tags","description":"Anonymous read-only official Store API data. No merchant key or OAuth is required. Availability depends on the store version and configuration. Password-protected reviews remain hidden. Each request costs 10 credits. Failed requests are automatically refunded.","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["storeUrl"],"additionalProperties":false,"properties":{"storeUrl":{"type":"string","description":"Public HTTPS store root or WordPress installation path.","maxLength":2048},"pageNum":{"type":"integer","description":"Page number, default 1.","maximum":10000,"minimum":1},"pageSize":{"type":"integer","description":"Page size, default 20, maximum 100.","maximum":100,"minimum":1},"keyword":{"type":"string","description":"Search within this store; at most 200 characters.","maxLength":200},"hideEmpty":{"type":"boolean","description":"Hide terms without products; defaults to the store's true setting."}},"type":"object"},"example":{"storeUrl":"https://example.com"}}}},"responses":{"200":{"description":"Inspect code: 0 means success. Each request costs 10 credits. Failed requests are automatically refunded.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"storeUrl":{"type":"string","description":"Normalized store identity.","example":"https://example.com"},"fetchedAt":{"type":"string","description":"Fetch time in epoch milliseconds; preserved on cache hits.","example":"1792972800000"},"cacheHit":{"type":"boolean","description":"Whether the response was served from the anonymous 60-second cache.","example":false},"tags":{"type":"array","description":"Normalized public data. Missing optional values are null or empty strings.","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Store-scoped ID string.","example":"1"},"name":{"type":"string","description":"Plain text name.","example":"Color"},"slug":{"type":"string","description":"Plain text or public URL; empty when unavailable. Images are not fetched.","example":"blue"},"description":{"type":"string","description":"Plain text or public URL; empty when unavailable. Images are not fetched.","example":""},"imageUrl":{"type":"string","description":"Plain text or public URL; empty when unavailable. Images are not fetched.","example":""},"url":{"type":"string","description":"Plain text or public URL; empty when unavailable. Images are not fetched.","example":""},"parentId":{"anyOf":[{"type":"string","description":"Parent ID; 0 is a root term, null means unavailable.","example":"0"},{"type":"null"}]},"count":{"anyOf":[{"type":"integer","description":"Associated product count, null when unavailable.","example":1},{"type":"null"}]}},"required":["id","name","slug","description","imageUrl","url"]}},"pageNum":{"type":"integer","description":"Pagination metadata; omitted upstream totals become null.","example":1},"pageSize":{"type":"integer","description":"Pagination metadata; omitted upstream totals become null.","example":20},"total":{"anyOf":[{"type":"integer","description":"Pagination metadata; omitted upstream totals become null.","example":1},{"type":"null"}]},"totalPages":{"anyOf":[{"type":"integer","description":"Pagination metadata; omitted upstream totals become null.","example":1},{"type":"null"}]},"hasMore":{"anyOf":[{"type":"boolean","description":"Null when upstream total pages are unavailable.","example":false},{"type":"null"}]}},"required":["storeUrl","fetchedAt","cacheHit","tags","pageNum","pageSize"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"storeUrl":"https://example.com","fetchedAt":1792972800000,"cacheHit":false,"tags":[{"id":"1","name":"Color","slug":"blue","description":"","imageUrl":"","url":"","parentId":"0","count":1}],"pageNum":1,"pageSize":20,"total":1,"totalPages":1,"hasMore":false},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/woocommerce/productBrands":{"post":{"operationId":"woocommerce_product_brands","tags":["WooCommerce"],"summary":"WooCommerce Product Brands","description":"Anonymous read-only official Store API data. No merchant key or OAuth is required. Availability depends on the store version and configuration. Password-protected reviews remain hidden. Each request costs 10 credits. Failed requests are automatically refunded.","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["storeUrl"],"additionalProperties":false,"properties":{"storeUrl":{"type":"string","description":"Public HTTPS store root or WordPress installation path.","maxLength":2048},"pageNum":{"type":"integer","description":"Page number, default 1.","maximum":10000,"minimum":1},"pageSize":{"type":"integer","description":"Page size, default 20, maximum 100.","maximum":100,"minimum":1},"keyword":{"type":"string","description":"Search within this store; at most 200 characters.","maxLength":200},"hideEmpty":{"type":"boolean","description":"Hide terms without products; defaults to the store's true setting."}},"type":"object"},"example":{"storeUrl":"https://example.com"}}}},"responses":{"200":{"description":"Inspect code: 0 means success. Each request costs 10 credits. Failed requests are automatically refunded.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"storeUrl":{"type":"string","description":"Normalized store identity.","example":"https://example.com"},"fetchedAt":{"type":"string","description":"Fetch time in epoch milliseconds; preserved on cache hits.","example":"1792972800000"},"cacheHit":{"type":"boolean","description":"Whether the response was served from the anonymous 60-second cache.","example":false},"brands":{"type":"array","description":"Normalized public data. Missing optional values are null or empty strings.","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Store-scoped ID string.","example":"1"},"name":{"type":"string","description":"Plain text name.","example":"Color"},"slug":{"type":"string","description":"Plain text or public URL; empty when unavailable. Images are not fetched.","example":"blue"},"description":{"type":"string","description":"Plain text or public URL; empty when unavailable. Images are not fetched.","example":""},"imageUrl":{"type":"string","description":"Plain text or public URL; empty when unavailable. Images are not fetched.","example":""},"url":{"type":"string","description":"Plain text or public URL; empty when unavailable. Images are not fetched.","example":""},"parentId":{"anyOf":[{"type":"string","description":"Parent ID; 0 is a root term, null means unavailable.","example":"0"},{"type":"null"}]},"count":{"anyOf":[{"type":"integer","description":"Associated product count, null when unavailable.","example":1},{"type":"null"}]}},"required":["id","name","slug","description","imageUrl","url"]}},"pageNum":{"type":"integer","description":"Pagination metadata; omitted upstream totals become null.","example":1},"pageSize":{"type":"integer","description":"Pagination metadata; omitted upstream totals become null.","example":20},"total":{"anyOf":[{"type":"integer","description":"Pagination metadata; omitted upstream totals become null.","example":1},{"type":"null"}]},"totalPages":{"anyOf":[{"type":"integer","description":"Pagination metadata; omitted upstream totals become null.","example":1},{"type":"null"}]},"hasMore":{"anyOf":[{"type":"boolean","description":"Null when upstream total pages are unavailable.","example":false},{"type":"null"}]}},"required":["storeUrl","fetchedAt","cacheHit","brands","pageNum","pageSize"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"storeUrl":"https://example.com","fetchedAt":1792972800000,"cacheHit":false,"brands":[{"id":"1","name":"Color","slug":"blue","description":"","imageUrl":"","url":"","parentId":"0","count":1}],"pageNum":1,"pageSize":20,"total":1,"totalPages":1,"hasMore":false},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/woocommerce/productAttributes":{"post":{"operationId":"woocommerce_product_attributes","tags":["WooCommerce"],"summary":"WooCommerce Product Attributes","description":"Anonymous read-only official Store API data. No merchant key or OAuth is required. Availability depends on the store version and configuration. Password-protected reviews remain hidden. Each request costs 10 credits. Failed requests are automatically refunded.","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["storeUrl"],"additionalProperties":false,"properties":{"storeUrl":{"type":"string","description":"Public HTTPS store root or WordPress installation path.","maxLength":2048}},"type":"object"},"example":{"storeUrl":"https://example.com"}}}},"responses":{"200":{"description":"Inspect code: 0 means success. Each request costs 10 credits. Failed requests are automatically refunded.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"storeUrl":{"type":"string","description":"Normalized store identity.","example":"https://example.com"},"fetchedAt":{"type":"string","description":"Fetch time in epoch milliseconds; preserved on cache hits.","example":"1792972800000"},"cacheHit":{"type":"boolean","description":"Whether the response was served from the anonymous 60-second cache.","example":false},"attributes":{"type":"array","description":"Normalized public data. Missing optional values are null or empty strings.","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Store-scoped ID string.","example":"1"},"name":{"type":"string","description":"Plain text name.","example":"Color"},"taxonomy":{"type":"string","description":"Public attribute metadata.","example":"pa_color"},"type":{"type":"string","description":"Public attribute metadata.","example":"select"},"order":{"type":"string","description":"Public attribute metadata.","example":"menu_order"},"hasArchives":{"anyOf":[{"type":"boolean","description":"Whether public archives are enabled; null when unavailable.","example":false},{"type":"null"}]}},"required":["id","name","taxonomy","type","order"]}}},"required":["storeUrl","fetchedAt","cacheHit","attributes"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"storeUrl":"https://example.com","fetchedAt":1792972800000,"cacheHit":false,"attributes":[{"id":"1","name":"Color","taxonomy":"pa_color","type":"select","order":"menu_order","hasArchives":false}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/woocommerce/productAttributeDetail":{"post":{"operationId":"woocommerce_product_attribute_detail","tags":["WooCommerce"],"summary":"WooCommerce Product Attribute Detail","description":"Anonymous read-only official Store API data. No merchant key or OAuth is required. Availability depends on the store version and configuration. Password-protected reviews remain hidden. Each request costs 10 credits. Failed requests are automatically refunded.","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["storeUrl","attributeId"],"additionalProperties":false,"properties":{"storeUrl":{"type":"string","description":"Public HTTPS store root or WordPress installation path.","maxLength":2048},"attributeId":{"type":"string","description":"Store-scoped attribute ID.","pattern":"^[1-9][0-9]{0,18}$"}},"type":"object"},"example":{"storeUrl":"https://example.com","attributeId":"1"}}}},"responses":{"200":{"description":"Inspect code: 0 means success. Each request costs 10 credits. Failed requests are automatically refunded.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"storeUrl":{"type":"string","description":"Normalized store identity.","example":"https://example.com"},"fetchedAt":{"type":"string","description":"Fetch time in epoch milliseconds; preserved on cache hits.","example":"1792972800000"},"cacheHit":{"type":"boolean","description":"Whether the response was served from the anonymous 60-second cache.","example":false},"attribute":{"type":"object","description":"Normalized public data. Missing optional values are null or empty strings.","example":{},"properties":{"id":{"type":"string","description":"Store-scoped ID string.","example":"1"},"name":{"type":"string","description":"Plain text name.","example":"Color"},"taxonomy":{"type":"string","description":"Public attribute metadata.","example":"pa_color"},"type":{"type":"string","description":"Public attribute metadata.","example":"select"},"order":{"type":"string","description":"Public attribute metadata.","example":"menu_order"},"hasArchives":{"anyOf":[{"type":"boolean","description":"Whether public archives are enabled; null when unavailable.","example":false},{"type":"null"}]}},"required":["id","name","taxonomy","type","order"]}},"required":["storeUrl","fetchedAt","cacheHit","attribute"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"storeUrl":"https://example.com","fetchedAt":1792972800000,"cacheHit":false,"attribute":{"id":"1","name":"Color","taxonomy":"pa_color","type":"select","order":"menu_order","hasArchives":false}},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/woocommerce/productAttributeTerms":{"post":{"operationId":"woocommerce_product_attribute_terms","tags":["WooCommerce"],"summary":"WooCommerce Product Attribute Terms","description":"Anonymous read-only official Store API data. No merchant key or OAuth is required. Availability depends on the store version and configuration. Password-protected reviews remain hidden. Each request costs 10 credits. Failed requests are automatically refunded.","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["storeUrl","attributeId"],"additionalProperties":false,"properties":{"storeUrl":{"type":"string","description":"Public HTTPS store root or WordPress installation path.","maxLength":2048},"attributeId":{"type":"string","description":"Store-scoped attribute ID.","pattern":"^[1-9][0-9]{0,18}$"}},"type":"object"},"example":{"storeUrl":"https://example.com","attributeId":"1"}}}},"responses":{"200":{"description":"Inspect code: 0 means success. Each request costs 10 credits. Failed requests are automatically refunded.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"storeUrl":{"type":"string","description":"Normalized store identity.","example":"https://example.com"},"fetchedAt":{"type":"string","description":"Fetch time in epoch milliseconds; preserved on cache hits.","example":"1792972800000"},"cacheHit":{"type":"boolean","description":"Whether the response was served from the anonymous 60-second cache.","example":false},"terms":{"type":"array","description":"Normalized public data. Missing optional values are null or empty strings.","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Store-scoped ID string.","example":"1"},"name":{"type":"string","description":"Plain text name.","example":"Color"},"slug":{"type":"string","description":"Plain text or public URL; empty when unavailable. Images are not fetched.","example":"blue"},"description":{"type":"string","description":"Plain text or public URL; empty when unavailable. Images are not fetched.","example":""},"imageUrl":{"type":"string","description":"Plain text or public URL; empty when unavailable. Images are not fetched.","example":""},"url":{"type":"string","description":"Plain text or public URL; empty when unavailable. Images are not fetched.","example":""},"parentId":{"anyOf":[{"type":"string","description":"Parent ID; 0 is a root term, null means unavailable.","example":"0"},{"type":"null"}]},"count":{"anyOf":[{"type":"integer","description":"Associated product count, null when unavailable.","example":1},{"type":"null"}]}},"required":["id","name","slug","description","imageUrl","url"]}}},"required":["storeUrl","fetchedAt","cacheHit","terms"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"storeUrl":"https://example.com","fetchedAt":1792972800000,"cacheHit":false,"terms":[{"id":"1","name":"Color","slug":"blue","description":"","imageUrl":"","url":"","parentId":"0","count":1}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/woocommerce/productReviews":{"post":{"operationId":"woocommerce_product_reviews","tags":["WooCommerce"],"summary":"WooCommerce Product Reviews","description":"Anonymous read-only official Store API data. No merchant key or OAuth is required. Availability depends on the store version and configuration. Password-protected reviews remain hidden. Each request costs 10 credits. Failed requests are automatically refunded.","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["storeUrl"],"additionalProperties":false,"properties":{"storeUrl":{"type":"string","description":"Public HTTPS store root or WordPress installation path.","maxLength":2048},"pageNum":{"type":"integer","description":"Page number, default 1.","maximum":10000,"minimum":1},"pageSize":{"type":"integer","description":"Page size, default 20, maximum 100.","maximum":100,"minimum":1},"productId":{"type":"string","description":"Only reviews for this product. Locked products return no public reviews.","pattern":"^[1-9][0-9]{0,18}$"},"categoryId":{"type":"string","description":"Restrict to a public product category.","pattern":"^[1-9][0-9]{0,18}$"}},"type":"object"},"example":{"storeUrl":"https://example.com"}}}},"responses":{"200":{"description":"Inspect code: 0 means success. Each request costs 10 credits. Failed requests are automatically refunded.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"storeUrl":{"type":"string","description":"Normalized store identity.","example":"https://example.com"},"fetchedAt":{"type":"string","description":"Fetch time in epoch milliseconds; preserved on cache hits.","example":"1792972800000"},"cacheHit":{"type":"boolean","description":"Whether the response was served from the anonymous 60-second cache.","example":false},"reviews":{"type":"array","description":"Normalized public data. Missing optional values are null or empty strings.","example":[],"items":{"type":"object","properties":{"id":{"type":"string","description":"Public review identifier or plain text; no reviewer email or private fields are exposed.","example":"83"},"productId":{"type":"string","description":"Public review identifier or plain text; no reviewer email or private fields are exposed.","example":"34"},"productName":{"type":"string","description":"Public review identifier or plain text; no reviewer email or private fields are exposed.","example":"Public review"},"productUrl":{"type":"string","description":"Public review identifier or plain text; no reviewer email or private fields are exposed.","example":"https://example.com/product/shirt"},"reviewer":{"type":"string","description":"Public review identifier or plain text; no reviewer email or private fields are exposed.","example":"Public review"},"review":{"type":"string","description":"Public review identifier or plain text; no reviewer email or private fields are exposed.","example":"Public review"},"rating":{"type":"integer","description":"Rating from 0 (unrated) to 5.","example":5},"verified":{"anyOf":[{"type":"boolean","description":"Verified purchase status, null when unavailable.","example":true},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string","description":"UTC creation time in epoch milliseconds, null when unavailable.","example":"1792972800000"},{"type":"null"}]}},"required":["id","productId","productName","productUrl","reviewer","review","rating"]}},"pageNum":{"type":"integer","description":"Pagination metadata; omitted upstream totals become null.","example":1},"pageSize":{"type":"integer","description":"Pagination metadata; omitted upstream totals become null.","example":20},"total":{"anyOf":[{"type":"integer","description":"Pagination metadata; omitted upstream totals become null.","example":1},{"type":"null"}]},"totalPages":{"anyOf":[{"type":"integer","description":"Pagination metadata; omitted upstream totals become null.","example":1},{"type":"null"}]},"hasMore":{"anyOf":[{"type":"boolean","description":"Null when upstream total pages are unavailable.","example":false},{"type":"null"}]}},"required":["storeUrl","fetchedAt","cacheHit","reviews","pageNum","pageSize"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"storeUrl":"https://example.com","fetchedAt":1792972800000,"cacheHit":false,"reviews":[{"id":"83","productId":"34","productName":"Public review","productUrl":"https://example.com/product/shirt","reviewer":"Public review","review":"Public review","rating":5,"verified":true,"createdAt":1792972800000}],"pageNum":1,"pageSize":20,"total":1,"totalPages":1,"hasMore":false},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/woocommerce/productCollectionData":{"post":{"operationId":"woocommerce_product_collection_data","tags":["WooCommerce"],"summary":"WooCommerce Product Collection Data","description":"Anonymous read-only official Store API data. No merchant key or OAuth is required. Availability depends on the store version and configuration. Password-protected reviews remain hidden. Each request costs 10 credits. Failed requests are automatically refunded.","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["storeUrl"],"additionalProperties":false,"properties":{"storeUrl":{"type":"string","description":"Public HTTPS store root or WordPress installation path.","maxLength":2048},"keyword":{"type":"string","description":"Search within this store; at most 200 characters.","maxLength":200},"categoryId":{"type":"string","description":"Restrict to a public product category.","pattern":"^[1-9][0-9]{0,18}$"},"calculatePriceRange":{"type":"boolean","description":"Calculate this aggregate; default true. Unsupported store fields may be null."},"calculateRatingCounts":{"type":"boolean","description":"Calculate this aggregate; default true. Unsupported store fields may be null."},"calculateStockStatusCounts":{"type":"boolean","description":"Calculate this aggregate; default true. Unsupported store fields may be null."},"attributeTaxonomies":{"type":"array","description":"Attribute taxonomies to count, using OR semantics, for example pa_color. Default empty.","maxItems":20,"items":{"pattern":"^pa_[a-z0-9_-]{1,28}$","type":"string"}},"taxonomies":{"type":"array","description":"Public taxonomies to count; default empty. Store support varies.","maxItems":20,"items":{"type":"string","enum":["product_cat","product_tag","product_brand"]}}},"type":"object"},"example":{"storeUrl":"https://example.com"}}}},"responses":{"200":{"description":"Inspect code: 0 means success. Each request costs 10 credits. Failed requests are automatically refunded.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"storeUrl":{"type":"string","description":"Normalized store identity.","example":"https://example.com"},"fetchedAt":{"type":"string","description":"Fetch time in epoch milliseconds; preserved on cache hits.","example":"1792972800000"},"cacheHit":{"type":"boolean","description":"Whether the response was served from the anonymous 60-second cache.","example":false},"collection":{"type":"object","description":"Normalized public data. Missing optional values are null or empty strings.","example":{},"properties":{"priceRange":{"anyOf":[{"type":"object","description":"Null when disabled or unavailable; exact decimal strings.","example":{},"properties":{"currency":{"type":"string","description":"Currency code.","example":"USD"},"minorUnit":{"type":"integer","description":"Currency decimal precision.","example":2},"minPrice":{"type":"string","description":"Exact amount; Minor suffix denotes original smallest-unit value.","example":"10.00"},"maxPrice":{"type":"string","description":"Exact amount; Minor suffix denotes original smallest-unit value.","example":"10.00"},"minPriceMinor":{"type":"string","description":"Exact amount; Minor suffix denotes original smallest-unit value.","example":"1000"},"maxPriceMinor":{"type":"string","description":"Exact amount; Minor suffix denotes original smallest-unit value.","example":"1000"}},"required":["currency","minorUnit","minPrice","maxPrice","minPriceMinor","maxPriceMinor"]},{"type":"null"}]},"attributeCounts":{"anyOf":[{"type":"array","description":"Null when disabled or unsupported by the store; empty array means no matches.","example":[],"items":{"type":"object","properties":{"termId":{"type":"string","description":"Public aggregate bucket.","example":"16"},"count":{"type":"integer","description":"Product count in this bucket.","example":1}},"required":["termId","count"]}},{"type":"null"}]},"ratingCounts":{"anyOf":[{"type":"array","description":"Null when disabled or unsupported by the store; empty array means no matches.","example":[],"items":{"type":"object","properties":{"rating":{"type":"integer","description":"Public aggregate bucket.","example":5},"count":{"type":"integer","description":"Product count in this bucket.","example":1}},"required":["rating","count"]}},{"type":"null"}]},"stockStatusCounts":{"anyOf":[{"type":"array","description":"Null when disabled or unsupported by the store; empty array means no matches.","example":[],"items":{"type":"object","properties":{"status":{"type":"string","description":"Public aggregate bucket.","example":"instock"},"count":{"type":"integer","description":"Product count in this bucket.","example":1}},"required":["status","count"]}},{"type":"null"}]},"taxonomyCounts":{"anyOf":[{"type":"array","description":"Null when disabled or unsupported by the store; empty array means no matches.","example":[],"items":{"type":"object","properties":{"termId":{"type":"string","description":"Public aggregate bucket.","example":"16"},"count":{"type":"integer","description":"Product count in this bucket.","example":1}},"required":["termId","count"]}},{"type":"null"}]}}}},"required":["storeUrl","fetchedAt","cacheHit","collection"],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"storeUrl":"https://example.com","fetchedAt":1792972800000,"cacheHit":false,"collection":{"priceRange":{"currency":"USD","minorUnit":2,"minPrice":"10.00","maxPrice":"10.00","minPriceMinor":"1000","maxPriceMinor":"1000"},"attributeCounts":[{"termId":"16","count":1}],"ratingCounts":[{"rating":5,"count":1}],"stockStatusCounts":[{"status":"instock","count":1}],"taxonomyCounts":[{"termId":"16","count":1}]}},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/alibaba1688/imageSearch":{"post":{"operationId":"data_alibaba1688_image_search_public","summary":"1688 Sourcing: image Search API","description":"1688 Sourcing: image Search API. Supply a JPEG/PNG image URL, pure Base64, or a returned imageId. Direct API calls do not perform the Skill image conversion step.","x-nexscope-slug":"data-alibaba1688-image-search","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imageUrl":{"type":"string","description":"Image URL, maximum length 1000; only supports png/jpg/jpeg; choose one of `imageBase64`, `imageId`","maxLength":1000},"imageBase64":{"type":"string","description":"Pure Base64 encoding, does not contain `data:image/jpeg;base64,` prefix; only supports png/jpg/jpeg; choose one of `imageUrl` and `imageId`"},"imageId":{"type":"string","description":"1688 picture ID; it is recommended to carry `page>1` when paging, which can speed up the response; choose one of three `imageUrl` and `imageBase64`"},"page":{"type":"integer","description":"Page number, starting from 1","default":1,"minimum":1},"pageSize":{"type":"integer","description":"The number of products per page cannot exceed 50","default":20,"minimum":1,"maximum":50},"priceStart":{"type":"string","description":"Price filter starting value (RMB), such as `10`"},"priceEnd":{"type":"string","description":"Price filter end value (RMB), such as `100`"},"filter":{"type":"string","description":"Comma-separated filters: 1688Selection, certifiedFactory, totalEpScoreLv1, totalEpScoreLv2, totalEpScoreLv3, totalEpScoreLv4, qrr0, qrr1, qrr5, qrr10, shipInToday, shipIn24Hours, shipIn48Hours, noReason7DReturn, isOnePsale, isOnePsaleFreePost, new7, new30, isQqyx, JPFL, USFL, KRFL, VNFL, SAFL, RUFL, KZFL, HKFL, MOFL, TWFL."},"sort":{"type":"string","description":"JSON-encoded string: price, rePurchaseRate, or monthSold with asc or desc.","default":"{\"monthSold\":\"desc\"}"},"keyword":{"type":"string","description":"Keywords to further search in the results"},"productCollectionId":{"type":"string","description":"One cross-border product collection ID from the allowed values.","enum":["262105288","262105286","262105253","262105281","262105280","262105277","262105276","262105274","262105269","262185282"]}},"required":[],"additionalProperties":true,"anyOf":[{"required":["imageUrl"]},{"required":["imageBase64"]},{"required":["imageId"]}]},"example":{"imageUrl":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg","page":1,"pageSize":20,"filter":"1688Selection,totalEpScoreLv1,qrr0","sort":"{\"price\":\"desc\"}"}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"imageId":{"anyOf":[{"type":"string","description":"The image ID after uploading; returning it during paging query can speed up the process"},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"Quantity of products on this page"},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total pages"},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type, fixed to `1688`"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendering style, fixed to `productWorkbenches`"},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render column definition","items":{}},{"type":"null"}]},"products":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"offerId":{"type":"string","description":"Product ID"},"asin":{"type":"string","description":"Item number, same as `offerId`"},"imageUrl":{"type":"string","description":"Product pictures"},"title":{"type":"string","description":"Product title"},"price":{"type":"number","description":"Wholesale price (yuan)"},"consignPrice":{"type":"number","description":"Price for one piece (yuan)"},"salesQuantity":{"type":"integer","description":"Number of pieces sold per month"},"estimatedSalesAmount":{"type":"number","description":"Estimated sales"},"asinUrl":{"type":"string","description":"Product link"},"isOnePsale":{"type":"string","description":"Whether to ship on behalf of one piece (yes/no)"},"isJxhy":{"type":"string","description":"Whether to select supply sources (yes/no)"},"sellerIdentities":{"type":"string","description":"Merchant identity (super factory/powerful merchant/integrity member)"},"offerIdentities":{"type":"string","description":"Product label (carefully selected)"},"repurchaseRate":{"type":"string","description":"Repurchase rate"},"tradeScore":{"type":"string","description":"Product Transaction Rating"},"compositeServiceScore":{"type":"string","description":"Comprehensive service experience points"},"sendGoodsAddressText":{"type":"string","description":"Place of shipment"},"deliveryTime":{"type":"string","description":"Shipping time (24/48 hours)"},"quantityBegin":{"type":"integer","description":"Minimum batch size"},"hasPromotion":{"type":"string","description":"Is there a marketing campaign (yes/no)"},"promotionType":{"type":"string","description":"marketing type"},"isPatentProduct":{"type":"string","description":"Is it a patented product (yes/no)"},"isSelect":{"type":"string","description":"Cross-Border Select Pallet Identification"},"currency":{"type":"string","description":"Currency, fixed to `¥`"},"sourceType":{"type":"string","description":"Source type, fixed to `1688`"},"dataType":{"type":"string","description":"Data type, fixed to `monthlyData`"}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"offerId":"1234567890123456789","title":"Example product","price":4.2,"currency":"CNY"}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-alibaba1688-image-search/run":{"post":{"operationId":"data_alibaba1688_image_search_run","summary":"1688 Sourcing: image Search API","description":"1688 Sourcing: image Search API. Supply a JPEG/PNG image URL, pure Base64, or a returned imageId. Direct API calls do not perform the Skill image conversion step.","x-nexscope-slug":"data-alibaba1688-image-search","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"imageUrl":{"type":"string","description":"Image URL, maximum length 1000; only supports png/jpg/jpeg; choose one of `imageBase64`, `imageId`","maxLength":1000},"imageBase64":{"type":"string","description":"Pure Base64 encoding, does not contain `data:image/jpeg;base64,` prefix; only supports png/jpg/jpeg; choose one of `imageUrl` and `imageId`"},"imageId":{"type":"string","description":"1688 picture ID; it is recommended to carry `page>1` when paging, which can speed up the response; choose one of three `imageUrl` and `imageBase64`"},"page":{"type":"integer","description":"Page number, starting from 1","default":1,"minimum":1},"pageSize":{"type":"integer","description":"The number of products per page cannot exceed 50","default":20,"minimum":1,"maximum":50},"priceStart":{"type":"string","description":"Price filter starting value (RMB), such as `10`"},"priceEnd":{"type":"string","description":"Price filter end value (RMB), such as `100`"},"filter":{"type":"string","description":"Comma-separated filters: 1688Selection, certifiedFactory, totalEpScoreLv1, totalEpScoreLv2, totalEpScoreLv3, totalEpScoreLv4, qrr0, qrr1, qrr5, qrr10, shipInToday, shipIn24Hours, shipIn48Hours, noReason7DReturn, isOnePsale, isOnePsaleFreePost, new7, new30, isQqyx, JPFL, USFL, KRFL, VNFL, SAFL, RUFL, KZFL, HKFL, MOFL, TWFL."},"sort":{"type":"string","description":"JSON-encoded string: price, rePurchaseRate, or monthSold with asc or desc.","default":"{\"monthSold\":\"desc\"}"},"keyword":{"type":"string","description":"Keywords to further search in the results"},"productCollectionId":{"type":"string","description":"One cross-border product collection ID from the allowed values.","enum":["262105288","262105286","262105253","262105281","262105280","262105277","262105276","262105274","262105269","262185282"]}},"required":[],"additionalProperties":true,"anyOf":[{"required":["imageUrl"]},{"required":["imageBase64"]},{"required":["imageId"]}]},"example":{"imageUrl":"https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg","page":1,"pageSize":20,"filter":"1688Selection,totalEpScoreLv1,qrr0","sort":"{\"price\":\"desc\"}"}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"imageId":{"anyOf":[{"type":"string","description":"The image ID after uploading; returning it during paging query can speed up the process"},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"Quantity of products on this page"},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total pages"},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Source type, fixed to `1688`"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendering style, fixed to `productWorkbenches`"},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render column definition","items":{}},{"type":"null"}]},"products":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"offerId":{"type":"string","description":"Product ID"},"asin":{"type":"string","description":"Item number, same as `offerId`"},"imageUrl":{"type":"string","description":"Product pictures"},"title":{"type":"string","description":"Product title"},"price":{"type":"number","description":"Wholesale price (yuan)"},"consignPrice":{"type":"number","description":"Price for one piece (yuan)"},"salesQuantity":{"type":"integer","description":"Number of pieces sold per month"},"estimatedSalesAmount":{"type":"number","description":"Estimated sales"},"asinUrl":{"type":"string","description":"Product link"},"isOnePsale":{"type":"string","description":"Whether to ship on behalf of one piece (yes/no)"},"isJxhy":{"type":"string","description":"Whether to select supply sources (yes/no)"},"sellerIdentities":{"type":"string","description":"Merchant identity (super factory/powerful merchant/integrity member)"},"offerIdentities":{"type":"string","description":"Product label (carefully selected)"},"repurchaseRate":{"type":"string","description":"Repurchase rate"},"tradeScore":{"type":"string","description":"Product Transaction Rating"},"compositeServiceScore":{"type":"string","description":"Comprehensive service experience points"},"sendGoodsAddressText":{"type":"string","description":"Place of shipment"},"deliveryTime":{"type":"string","description":"Shipping time (24/48 hours)"},"quantityBegin":{"type":"integer","description":"Minimum batch size"},"hasPromotion":{"type":"string","description":"Is there a marketing campaign (yes/no)"},"promotionType":{"type":"string","description":"marketing type"},"isPatentProduct":{"type":"string","description":"Is it a patented product (yes/no)"},"isSelect":{"type":"string","description":"Cross-Border Select Pallet Identification"},"currency":{"type":"string","description":"Currency, fixed to `¥`"},"sourceType":{"type":"string","description":"Source type, fixed to `1688`"},"dataType":{"type":"string","description":"Data type, fixed to `monthlyData`"}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"offerId":"1234567890123456789","title":"Example product","price":4.2,"currency":"CNY"}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/dl/productBillboard":{"post":{"operationId":"data_dl_product_billboard_public","summary":"1688 Sourcing: product Billboard API","description":"1688 Sourcing: product Billboard API. Chinese keywords are required when provided. Product IDs remain strings. Prices and sales estimates follow the requested statistical period.","x-nexscope-slug":"data-dl-product-billboard","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyWord":{"type":"string","description":"Chinese search keyword, at most 50 characters. Translate your search terms to Chinese before sending.","maxLength":50},"date":{"type":"string","description":"Weekly: Sunday within the last 90 days. Monthly: first day of a month within the last year. Omit for current default."},"pageType":{"type":"integer","description":"List type: `2` weekly list, `3` monthly list","default":3,"enum":[2,3]},"pageIndex":{"type":"integer","description":"Page number, starting from 1","default":1,"minimum":1},"pageSize":{"type":"integer","description":"Return quantity per page, range 10-100","default":20,"minimum":10,"maximum":100},"sortField":{"type":"string","description":"`orderCount` sales number, `saleCount` sales number, `saleVolume` estimated sales, `offerCreateTime` shelf time, `price` wholesale price, `consignPrice` consignment price","default":"orderCount"},"sortType":{"type":"string","description":"Sorting type: `desc` descending order, `asc` ascending order","default":"desc"},"searchType":{"type":"integer","description":"Product keyword search: `1` fuzzy matching, `3` precise matching","default":1},"offerType":{"type":"integer","description":"Product identification: `0` is not limited, `2` is new, `3` is carefully selected by 1688, `4` is cross-border, `5` supports customization, `6` is the treasure of the store","default":0},"companyType":{"type":"integer","description":"Company type: `0` unlimited, `1` shop, `2` factory"},"shiLiType":{"type":"string","description":"Seller membership type, separate multiple choices with commas: `superFactory` super factory, `Power` powerful merchant, `TrustPass` integrity member"},"beginTpYear":{"type":"integer","description":"Start the Integrity Pass period"},"endTpYear":{"type":"integer","description":"End of integrity pass period"},"beginPrice":{"type":"number","description":"Wholesale price starting value"},"endPrice":{"type":"number","description":"wholesale price ending value"},"beginConsignPrice":{"type":"number","description":"Starting value of agency price"},"endConsignPrice":{"type":"number","description":"The end value of the agency price"},"beginOrderCount":{"type":"integer","description":"Starting value of number of sales"},"endOrderCount":{"type":"integer","description":"Sales end value"},"beginSaleCount":{"type":"integer","description":"Starting value of sales units"},"endSaleCount":{"type":"integer","description":"Sales end value"},"beginSaleVolume":{"type":"number","description":"sales starting value"},"endSaleVolume":{"type":"number","description":"sales end value"},"beginStartQuantity":{"type":"integer","description":"Starting batch size"},"endStartQuantity":{"type":"integer","description":"end batch"},"beginOfferCreateTime":{"type":"string","description":"Starting value of shelf time, format `YYYY-MM-DD`"},"endOfferCreateTime":{"type":"string","description":"Shelf time end value, format `YYYY-MM-DD`"},"sendTime":{"type":"string","description":"Shipping time, multiple selections separated by commas: `24`, `48`, `72` hours"},"proxyRights":{"type":"string","description":"For drop-shipping rights, multiple options must be separated by commas: `4360897`, free shipping for one piece, `449154`, purchase first, pay later"},"shopService":{"type":"string","description":"Seller services, multiple selections separated by commas: `4057409` Safe Purchase, `888777` In-depth Certification Report"},"buyerProtections":{"type":"string","description":"Rights protection, separate multiple choices with commas: `Free shipping for goods`, `7-day return guarantee`, `Support freight insurance`"},"faceToFaceSupport":{"type":"string","description":"Farewell support, multiple selections separated by commas: `441218` Taobao, `386434` Douyin, `422914` Pinduoduo, `422978` Xiaohongshu, `386370` Kuaishou"},"productIds":{"type":"string","description":"Up to 20 product IDs separated by Chinese enumeration commas (、)."},"goodsUrl":{"type":"string","description":"Product link address"}},"required":[],"additionalProperties":true},"example":{"keyWord":"手机壳","pageIndex":1,"pageSize":20}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"rendering style"},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render column definition","items":{}},{"type":"null"}]},"products":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"offerId":{"type":"string","description":"Product ID"},"asin":{"type":"string","description":"Item number"},"title":{"type":"string","description":"Product title"},"price":{"type":"number","description":"wholesale price"},"consignPrice":{"type":"number","description":"Price on behalf of others"},"currency":{"type":"string","description":"Currency"},"unit":{"type":"string","description":"unit"},"quantityBegin":{"type":"integer","description":"Minimum batch size"},"quantityPrices":{"type":"string","description":"price range"},"salesOrderCount":{"type":"integer","description":"The number of sales, returns the corresponding value according to the statistical period"},"salesQuantity":{"type":"integer","description":"The number of pieces sold, returns the corresponding value according to the statistical period"},"estimatedSalesAmount":{"type":"integer","description":"Estimated sales, returning corresponding values according to statistical period"},"dataType":{"type":"string","description":"Data type: `weeklyData` weekly data, `monthlyData` monthly data"},"availableDate":{"type":"string","description":"Product shelf time, in the format of `yyyy-MM-dd HH:mm:ss`"},"deliveryTime":{"type":"string","description":"Shipping time"},"levelName":{"type":"string","description":"Category level name"},"company":{"type":"string","description":"Store name"},"shopId":{"type":"string","description":"Store ID"},"shopUrl":{"type":"string","description":"Store link address"},"asinUrl":{"type":"string","description":"Product link address"},"imageUrl":{"type":"string","description":"Image address"},"sourceType":{"type":"string","description":"Source platform (1688)"}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"offerId":"1234567890123456789","title":"Example product","price":4.2,"currency":"CNY"}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-dl-product-billboard/run":{"post":{"operationId":"data_dl_product_billboard_run","summary":"1688 Sourcing: product Billboard API","description":"1688 Sourcing: product Billboard API. Chinese keywords are required when provided. Product IDs remain strings. Prices and sales estimates follow the requested statistical period.","x-nexscope-slug":"data-dl-product-billboard","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyWord":{"type":"string","description":"Chinese search keyword, at most 50 characters. Translate your search terms to Chinese before sending.","maxLength":50},"date":{"type":"string","description":"Weekly: Sunday within the last 90 days. Monthly: first day of a month within the last year. Omit for current default."},"pageType":{"type":"integer","description":"List type: `2` weekly list, `3` monthly list","default":3,"enum":[2,3]},"pageIndex":{"type":"integer","description":"Page number, starting from 1","default":1,"minimum":1},"pageSize":{"type":"integer","description":"Return quantity per page, range 10-100","default":20,"minimum":10,"maximum":100},"sortField":{"type":"string","description":"`orderCount` sales number, `saleCount` sales number, `saleVolume` estimated sales, `offerCreateTime` shelf time, `price` wholesale price, `consignPrice` consignment price","default":"orderCount"},"sortType":{"type":"string","description":"Sorting type: `desc` descending order, `asc` ascending order","default":"desc"},"searchType":{"type":"integer","description":"Product keyword search: `1` fuzzy matching, `3` precise matching","default":1},"offerType":{"type":"integer","description":"Product identification: `0` is not limited, `2` is new, `3` is carefully selected by 1688, `4` is cross-border, `5` supports customization, `6` is the treasure of the store","default":0},"companyType":{"type":"integer","description":"Company type: `0` unlimited, `1` shop, `2` factory"},"shiLiType":{"type":"string","description":"Seller membership type, separate multiple choices with commas: `superFactory` super factory, `Power` powerful merchant, `TrustPass` integrity member"},"beginTpYear":{"type":"integer","description":"Start the Integrity Pass period"},"endTpYear":{"type":"integer","description":"End of integrity pass period"},"beginPrice":{"type":"number","description":"Wholesale price starting value"},"endPrice":{"type":"number","description":"wholesale price ending value"},"beginConsignPrice":{"type":"number","description":"Starting value of agency price"},"endConsignPrice":{"type":"number","description":"The end value of the agency price"},"beginOrderCount":{"type":"integer","description":"Starting value of number of sales"},"endOrderCount":{"type":"integer","description":"Sales end value"},"beginSaleCount":{"type":"integer","description":"Starting value of sales units"},"endSaleCount":{"type":"integer","description":"Sales end value"},"beginSaleVolume":{"type":"number","description":"sales starting value"},"endSaleVolume":{"type":"number","description":"sales end value"},"beginStartQuantity":{"type":"integer","description":"Starting batch size"},"endStartQuantity":{"type":"integer","description":"end batch"},"beginOfferCreateTime":{"type":"string","description":"Starting value of shelf time, format `YYYY-MM-DD`"},"endOfferCreateTime":{"type":"string","description":"Shelf time end value, format `YYYY-MM-DD`"},"sendTime":{"type":"string","description":"Shipping time, multiple selections separated by commas: `24`, `48`, `72` hours"},"proxyRights":{"type":"string","description":"For drop-shipping rights, multiple options must be separated by commas: `4360897`, free shipping for one piece, `449154`, purchase first, pay later"},"shopService":{"type":"string","description":"Seller services, multiple selections separated by commas: `4057409` Safe Purchase, `888777` In-depth Certification Report"},"buyerProtections":{"type":"string","description":"Rights protection, separate multiple choices with commas: `Free shipping for goods`, `7-day return guarantee`, `Support freight insurance`"},"faceToFaceSupport":{"type":"string","description":"Farewell support, multiple selections separated by commas: `441218` Taobao, `386434` Douyin, `422914` Pinduoduo, `422978` Xiaohongshu, `386370` Kuaishou"},"productIds":{"type":"string","description":"Up to 20 product IDs separated by Chinese enumeration commas (、)."},"goodsUrl":{"type":"string","description":"Product link address"}},"required":[],"additionalProperties":true},"example":{"keyWord":"手机壳","pageIndex":1,"pageSize":20}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"rendering style"},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render column definition","items":{}},{"type":"null"}]},"products":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"offerId":{"type":"string","description":"Product ID"},"asin":{"type":"string","description":"Item number"},"title":{"type":"string","description":"Product title"},"price":{"type":"number","description":"wholesale price"},"consignPrice":{"type":"number","description":"Price on behalf of others"},"currency":{"type":"string","description":"Currency"},"unit":{"type":"string","description":"unit"},"quantityBegin":{"type":"integer","description":"Minimum batch size"},"quantityPrices":{"type":"string","description":"price range"},"salesOrderCount":{"type":"integer","description":"The number of sales, returns the corresponding value according to the statistical period"},"salesQuantity":{"type":"integer","description":"The number of pieces sold, returns the corresponding value according to the statistical period"},"estimatedSalesAmount":{"type":"integer","description":"Estimated sales, returning corresponding values according to statistical period"},"dataType":{"type":"string","description":"Data type: `weeklyData` weekly data, `monthlyData` monthly data"},"availableDate":{"type":"string","description":"Product shelf time, in the format of `yyyy-MM-dd HH:mm:ss`"},"deliveryTime":{"type":"string","description":"Shipping time"},"levelName":{"type":"string","description":"Category level name"},"company":{"type":"string","description":"Store name"},"shopId":{"type":"string","description":"Store ID"},"shopUrl":{"type":"string","description":"Store link address"},"asinUrl":{"type":"string","description":"Product link address"},"imageUrl":{"type":"string","description":"Image address"},"sourceType":{"type":"string","description":"Source platform (1688)"}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"offerId":"1234567890123456789","title":"Example product","price":4.2,"currency":"CNY"}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/dl/productSearch":{"post":{"operationId":"data_dl_product_search_public","summary":"1688 Sourcing: product Search API","description":"1688 Sourcing: product Search API. Chinese keywords are required when provided. Product IDs remain strings. Prices and sales estimates follow the requested statistical period.","x-nexscope-slug":"data-dl-product-search","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyWord":{"type":"string","description":"Chinese search keyword, at most 50 characters. Translate your search terms to Chinese before sending.","maxLength":50},"goodsUrl":{"type":"string","description":"Product link address, choose one from `keyWord`"},"productIds":{"type":"string","description":"Up to 20 product IDs separated by commas (,)."},"cycle":{"type":"string","description":"Statistical period: `7` last 7 days or `30` last 30 days"},"searchType":{"type":"integer","description":"Search type: `1` fuzzy matching, `3` precise matching","default":1},"sortField":{"type":"string","description":"`orderCount7d`、`saleCount7d`、`saleVolume7d`、`orderCount30d`、`saleCount30d`、`saleVolume30d`、`offerCreateTime`、`price`、`consignPrice`","default":"orderCount30d"},"sortType":{"type":"string","description":"Sorting type: `desc` descending order, `asc` ascending order","default":"desc"},"pageIndex":{"type":"integer","description":"Page number, starting from 1","default":1,"minimum":1},"pageSize":{"type":"integer","description":"Quantity per page, range 10-100","default":20,"minimum":10,"maximum":100},"beginPrice":{"type":"number","description":"Wholesale price starting value"},"endPrice":{"type":"number","description":"wholesale price ending value"},"beginConsignPrice":{"type":"number","description":"Starting value of agency price"},"endConsignPrice":{"type":"number","description":"The end value of the agency price"},"beginOrderCount":{"type":"integer","description":"Starting value of number of sales"},"endOrderCount":{"type":"integer","description":"Sales end value"},"beginSaleCount":{"type":"integer","description":"Starting value of sales units"},"endSaleCount":{"type":"integer","description":"Sales end value"},"beginSaleVolume":{"type":"number","description":"sales starting value"},"endSaleVolume":{"type":"number","description":"sales end value"},"beginStartQuantity":{"type":"integer","description":"Starting value of minimum purchase quantity"},"endStartQuantity":{"type":"integer","description":"Minimum purchase quantity end value"},"beginTpYear":{"type":"integer","description":"Starting value of the credit pass period"},"endTpYear":{"type":"integer","description":"Integrity Pass life end value"},"beginOfferCreateTime":{"type":"string","description":"Starting value of shelf time, format `YYYY-MM-DD`"},"endOfferCreateTime":{"type":"string","description":"Shelf time end value, format `YYYY-MM-DD`"},"companyType":{"type":"integer","description":"Company type: `0` unlimited, `1` shop, `2` factory","default":0},"offerType":{"type":"integer","description":"Product identification: `0` is not limited, `2` is new, `3` is 1688 carefully selected, `4` is cross-border, `5` supports customization, `6` is the treasure of the store","default":0},"shiLiType":{"type":"string","description":"Seller type, multiple selections separated by commas: `superFactory`, `Power`, `TrustPass`"},"sendTime":{"type":"string","description":"Shipping time, multiple selections separated by commas: `24`, `48`, `72`"},"faceToFaceSupport":{"type":"string","description":"Farewell support, multiple selections separated by commas: `441218` Taobao, `386434` Douyin, `422914` Pinduoduo, `422978` Xiaohongshu, `386370` Kuaishou"},"proxyRights":{"type":"string","description":"For drop-shipping rights, multiple options must be separated by commas: `4360897`, free shipping for one piece, `449154`, purchase first, pay later"},"shopService":{"type":"string","description":"Seller services, multiple selections separated by commas: `4057409` Safe Purchase, `888777` In-depth Certification Report"},"buyerProtections":{"type":"string","description":"Rights protection, separate multiple choices with commas: `Free shipping for goods`, `7-day return guarantee`, `Support freight insurance`"}},"required":[],"additionalProperties":true},"example":{"keyWord":"瑜伽垫","pageIndex":1,"pageSize":20}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total number of records"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"rendering style"},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render column definition","items":{}},{"type":"null"}]},"products":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"offerId":{"type":"string","description":"Product ID"},"asin":{"type":"string","description":"Item number"},"title":{"type":"string","description":"Product title"},"asinUrl":{"type":"string","description":"Product link address"},"imageUrl":{"type":"string","description":"Product picture address"},"price":{"type":"number","description":"wholesale price"},"consignPrice":{"type":"number","description":"Price on behalf of others"},"quantityPrices":{"type":"string","description":"price range"},"quantityBegin":{"type":"integer","description":"Minimum batch size"},"unit":{"type":"string","description":"unit"},"currency":{"type":"string","description":"Currency"},"salesOrderCount":{"type":"integer","description":"Number of sales, returned according to statistical period"},"salesQuantity":{"type":"integer","description":"Number of pieces sold, returned according to statistical period"},"estimatedSalesAmount":{"type":"integer","description":"Estimated sales, returned according to statistical period"},"deliveryTime":{"type":"string","description":"Shipping time"},"availableDate":{"type":"string","description":"Product shelf time"},"levelName":{"type":"string","description":"Category level name"},"company":{"type":"string","description":"Store name"},"shopId":{"type":"string","description":"Store ID"},"shopUrl":{"type":"string","description":"Store link address"},"dataType":{"type":"string","description":"Data type: `weeklyData` weekly data, `monthlyData` monthly data"},"sourceType":{"type":"string","description":"Source platform (1688)"}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"offerId":"1234567890123456789","title":"Example product","price":4.2,"currency":"CNY"}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-dl-product-search/run":{"post":{"operationId":"data_dl_product_search_run","summary":"1688 Sourcing: product Search API","description":"1688 Sourcing: product Search API. Chinese keywords are required when provided. Product IDs remain strings. Prices and sales estimates follow the requested statistical period.","x-nexscope-slug":"data-dl-product-search","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyWord":{"type":"string","description":"Chinese search keyword, at most 50 characters. Translate your search terms to Chinese before sending.","maxLength":50},"goodsUrl":{"type":"string","description":"Product link address, choose one from `keyWord`"},"productIds":{"type":"string","description":"Up to 20 product IDs separated by commas (,)."},"cycle":{"type":"string","description":"Statistical period: `7` last 7 days or `30` last 30 days"},"searchType":{"type":"integer","description":"Search type: `1` fuzzy matching, `3` precise matching","default":1},"sortField":{"type":"string","description":"`orderCount7d`、`saleCount7d`、`saleVolume7d`、`orderCount30d`、`saleCount30d`、`saleVolume30d`、`offerCreateTime`、`price`、`consignPrice`","default":"orderCount30d"},"sortType":{"type":"string","description":"Sorting type: `desc` descending order, `asc` ascending order","default":"desc"},"pageIndex":{"type":"integer","description":"Page number, starting from 1","default":1,"minimum":1},"pageSize":{"type":"integer","description":"Quantity per page, range 10-100","default":20,"minimum":10,"maximum":100},"beginPrice":{"type":"number","description":"Wholesale price starting value"},"endPrice":{"type":"number","description":"wholesale price ending value"},"beginConsignPrice":{"type":"number","description":"Starting value of agency price"},"endConsignPrice":{"type":"number","description":"The end value of the agency price"},"beginOrderCount":{"type":"integer","description":"Starting value of number of sales"},"endOrderCount":{"type":"integer","description":"Sales end value"},"beginSaleCount":{"type":"integer","description":"Starting value of sales units"},"endSaleCount":{"type":"integer","description":"Sales end value"},"beginSaleVolume":{"type":"number","description":"sales starting value"},"endSaleVolume":{"type":"number","description":"sales end value"},"beginStartQuantity":{"type":"integer","description":"Starting value of minimum purchase quantity"},"endStartQuantity":{"type":"integer","description":"Minimum purchase quantity end value"},"beginTpYear":{"type":"integer","description":"Starting value of the credit pass period"},"endTpYear":{"type":"integer","description":"Integrity Pass life end value"},"beginOfferCreateTime":{"type":"string","description":"Starting value of shelf time, format `YYYY-MM-DD`"},"endOfferCreateTime":{"type":"string","description":"Shelf time end value, format `YYYY-MM-DD`"},"companyType":{"type":"integer","description":"Company type: `0` unlimited, `1` shop, `2` factory","default":0},"offerType":{"type":"integer","description":"Product identification: `0` is not limited, `2` is new, `3` is 1688 carefully selected, `4` is cross-border, `5` supports customization, `6` is the treasure of the store","default":0},"shiLiType":{"type":"string","description":"Seller type, multiple selections separated by commas: `superFactory`, `Power`, `TrustPass`"},"sendTime":{"type":"string","description":"Shipping time, multiple selections separated by commas: `24`, `48`, `72`"},"faceToFaceSupport":{"type":"string","description":"Farewell support, multiple selections separated by commas: `441218` Taobao, `386434` Douyin, `422914` Pinduoduo, `422978` Xiaohongshu, `386370` Kuaishou"},"proxyRights":{"type":"string","description":"For drop-shipping rights, multiple options must be separated by commas: `4360897`, free shipping for one piece, `449154`, purchase first, pay later"},"shopService":{"type":"string","description":"Seller services, multiple selections separated by commas: `4057409` Safe Purchase, `888777` In-depth Certification Report"},"buyerProtections":{"type":"string","description":"Rights protection, separate multiple choices with commas: `Free shipping for goods`, `7-day return guarantee`, `Support freight insurance`"}},"required":[],"additionalProperties":true},"example":{"keyWord":"瑜伽垫","pageIndex":1,"pageSize":20}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Total number of records"},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"rendering style"},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render column definition","items":{}},{"type":"null"}]},"products":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"offerId":{"type":"string","description":"Product ID"},"asin":{"type":"string","description":"Item number"},"title":{"type":"string","description":"Product title"},"asinUrl":{"type":"string","description":"Product link address"},"imageUrl":{"type":"string","description":"Product picture address"},"price":{"type":"number","description":"wholesale price"},"consignPrice":{"type":"number","description":"Price on behalf of others"},"quantityPrices":{"type":"string","description":"price range"},"quantityBegin":{"type":"integer","description":"Minimum batch size"},"unit":{"type":"string","description":"unit"},"currency":{"type":"string","description":"Currency"},"salesOrderCount":{"type":"integer","description":"Number of sales, returned according to statistical period"},"salesQuantity":{"type":"integer","description":"Number of pieces sold, returned according to statistical period"},"estimatedSalesAmount":{"type":"integer","description":"Estimated sales, returned according to statistical period"},"deliveryTime":{"type":"string","description":"Shipping time"},"availableDate":{"type":"string","description":"Product shelf time"},"levelName":{"type":"string","description":"Category level name"},"company":{"type":"string","description":"Store name"},"shopId":{"type":"string","description":"Store ID"},"shopUrl":{"type":"string","description":"Store link address"},"dataType":{"type":"string","description":"Data type: `weeklyData` weekly data, `monthlyData` monthly data"},"sourceType":{"type":"string","description":"Source platform (1688)"}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"total":1,"products":[{"offerId":"1234567890123456789","title":"Example product","price":4.2,"currency":"CNY"}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/alibaba1688/authorizeUrl":{"post":{"operationId":"data_alibaba1688_authorize_url_public","summary":"1688 Authorize URL","description":"Authorize URL for the currently authenticated Nexscope user. Use your Nexscope API key. Complete authorization manually, then verify ACTIVE and expired=false. Before previewing or placing an order, bind Alipay to that same 1688 buyer account on 1688. OAuth authorization alone does not complete this step. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-authorize-url","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountName":{"type":"string","description":"Display name for this authorization."}},"required":["accountName"],"additionalProperties":true},"example":{"accountName":"My 1688 account"}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"authorizeUrl":{"anyOf":[{"type":"string","description":"Open manually to authorize. Never expose tokens."},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"authorizeUrl":"https://auth.1688.com/example"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-alibaba1688-authorize-url/run":{"post":{"operationId":"data_alibaba1688_authorize_url_run","summary":"1688 Authorize URL","description":"Authorize URL for the currently authenticated Nexscope user. Use your Nexscope API key. Complete authorization manually, then verify ACTIVE and expired=false. Before previewing or placing an order, bind Alipay to that same 1688 buyer account on 1688. OAuth authorization alone does not complete this step. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-authorize-url","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accountName":{"type":"string","description":"Display name for this authorization."}},"required":["accountName"],"additionalProperties":true},"example":{"accountName":"My 1688 account"}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"authorizeUrl":{"anyOf":[{"type":"string","description":"Open manually to authorize. Never expose tokens."},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"authorizeUrl":"https://auth.1688.com/example"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/alibaba1688/authorizedStores":{"post":{"operationId":"data_alibaba1688_authorized_stores_public","summary":"1688 Authorized Stores","description":"Authorized Stores for the currently authenticated Nexscope user. Use your Nexscope API key. Complete authorization manually, then verify ACTIVE and expired=false. Before previewing or placing an order, bind Alipay to that same 1688 buyer account on 1688. An ACTIVE store does not confirm Alipay binding. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-authorized-stores","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":true},"example":{}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"stores":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"accountName":{"type":"string","description":""},"status":{"type":"string","description":"ACTIVE is required."},"expired":{"type":"boolean","description":"Must be false to continue."}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"stores":[{"accountName":"My 1688 account","status":"ACTIVE","expired":false}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-alibaba1688-authorized-stores/run":{"post":{"operationId":"data_alibaba1688_authorized_stores_run","summary":"1688 Authorized Stores","description":"Authorized Stores for the currently authenticated Nexscope user. Use your Nexscope API key. Complete authorization manually, then verify ACTIVE and expired=false. Before previewing or placing an order, bind Alipay to that same 1688 buyer account on 1688. An ACTIVE store does not confirm Alipay binding. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-authorized-stores","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":true},"example":{}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"stores":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"accountName":{"type":"string","description":""},"status":{"type":"string","description":"ACTIVE is required."},"expired":{"type":"boolean","description":"Must be false to continue."}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"stores":[{"accountName":"My 1688 account","status":"ACTIVE","expired":false}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/alibaba1688/receiveAddressList":{"post":{"operationId":"data_alibaba1688_receive_address_list_public","summary":"1688 Receive Address List","description":"Receive Address List for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-receive-address-list","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":true},"example":{}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"items":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"addressId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"fullName":{"type":"string","description":"Recipient name."},"mobile":{"type":"string","description":"Recipient phone; avoid sharing outside the request."},"address":{"type":"string","description":"Street address."},"provinceText":{"type":"string","description":""},"cityText":{"type":"string","description":""},"areaText":{"type":"string","description":""},"isDefault":{"type":"boolean","description":""}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"items":[{"addressId":"987654321012345678","fullName":"Example recipient","mobile":"13800000000","address":"Example street 1","isDefault":true}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-alibaba1688-receive-address-list/run":{"post":{"operationId":"data_alibaba1688_receive_address_list_run","summary":"1688 Receive Address List","description":"Receive Address List for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-receive-address-list","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":true},"example":{}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"items":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"addressId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"fullName":{"type":"string","description":"Recipient name."},"mobile":{"type":"string","description":"Recipient phone; avoid sharing outside the request."},"address":{"type":"string","description":"Street address."},"provinceText":{"type":"string","description":""},"cityText":{"type":"string","description":""},"areaText":{"type":"string","description":""},"isDefault":{"type":"boolean","description":""}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"items":[{"addressId":"987654321012345678","fullName":"Example recipient","mobile":"13800000000","address":"Example street 1","isDefault":true}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/alibaba1688/sku":{"post":{"operationId":"data_alibaba1688_sku_public","summary":"1688 SKU","description":"SKU for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-sku","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"offerId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"}},"required":["offerId"],"additionalProperties":true},"example":{"offerId":"1234567890123456789"}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"offerId":{"anyOf":[{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},{"type":"null"}]},"skuList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"specId":{"type":"string","description":""},"skuId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"price":{"type":"number","description":"CNY; use orderPreview for final payable price."},"amountOnSale":{"type":"integer","description":""},"attributes":{"type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"skuImageUrl":{"type":"string","description":""}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"offerId":"1234567890123456789","skuList":[{"specId":"example-spec","skuId":"456789012345678901","price":4.2,"amountOnSale":100}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-alibaba1688-sku/run":{"post":{"operationId":"data_alibaba1688_sku_run","summary":"1688 SKU","description":"SKU for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-sku","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"offerId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"}},"required":["offerId"],"additionalProperties":true},"example":{"offerId":"1234567890123456789"}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"offerId":{"anyOf":[{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},{"type":"null"}]},"skuList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"specId":{"type":"string","description":""},"skuId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"price":{"type":"number","description":"CNY; use orderPreview for final payable price."},"amountOnSale":{"type":"integer","description":""},"attributes":{"type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},"skuImageUrl":{"type":"string","description":""}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"offerId":"1234567890123456789","skuList":[{"specId":"example-spec","skuId":"456789012345678901","price":4.2,"amountOnSale":100}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/alibaba1688/orderPreview":{"post":{"operationId":"data_alibaba1688_order_preview_public","summary":"1688 Order Preview","description":"Order Preview for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user and an Alipay account bound to that same 1688 buyer account. If 1688 returns BUYER_NOT_BIND_ALIPAY, complete the binding on 1688 before retrying. Procurement responses are live; do not cache or automatically retry writes. Stop on status=false even if the envelope succeeds. Totals are cents; cargo prices are CNY yuan.","x-nexscope-slug":"data-alibaba1688-order-preview","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"addressId":{"type":"string","description":"Select from receiveAddressList."},"addressParam":{"type":"object","properties":{"fullName":{"type":"string","description":"Recipient name."},"mobile":{"type":"string","description":"Recipient phone; avoid sharing outside the request."},"address":{"type":"string","description":"Street address."},"provinceText":{"type":"string","description":""},"cityText":{"type":"string","description":""},"areaText":{"type":"string","description":""},"postCode":{"type":"string","description":"Postal code."},"phone":{"type":"string","description":"Landline phone number."}},"required":["fullName","mobile","address"],"additionalProperties":true},"cargoParamList":{"type":"array","items":{"type":"object","properties":{"offerId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"specId":{"type":"string","description":"SKU specification identifier."},"quantity":{"type":"integer","description":"Quantity in the selling unit.","minimum":1}},"required":["offerId","quantity"],"additionalProperties":true},"minItems":1},"flow":{"type":"string","description":"Order flow; defaults to general when omitted.","enum":["general","fenxiao","boutiquefenxiao"],"default":"general"},"isvBizType":{"type":"string","description":"Cross-border business type.","enum":["cross","cross_daigou","cross_distribution"],"default":"cross"},"useBorderLogisticsSolution":{"type":"boolean","description":"Whether to use a cross-border logistics solution."},"crossBorderLogisticsSolutionId":{"type":"string","description":"Cross-border logistics solution sourceId."},"invoiceParam":{"type":"object","description":"Optional invoice details for order preview.","properties":{"invoiceType":{"type":"integer","description":"0: ordinary invoice; 1: special VAT invoice."},"titleType":{"type":"integer","description":"1: personal; 2: company."},"title":{"type":"string","description":"Invoice title."},"taxpayerNumber":{"type":"string","description":"Taxpayer number."},"bankName":{"type":"string","description":"Bank name."},"bankAccount":{"type":"string","description":"Bank account."},"address":{"type":"string","description":"Registered address."},"phone":{"type":"string","description":"Registered phone number."}},"additionalProperties":true}},"required":["cargoParamList"],"additionalProperties":true,"anyOf":[{"required":["addressId"]},{"required":["addressParam"]}]},"example":{"addressId":"987654321012345678","flow":"general","cargoParamList":[{"offerId":"1234567890123456789","specId":"example-spec","quantity":2}]}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"status":{"anyOf":[{"type":"boolean","description":"false means do not create an order."},{"type":"null"}]},"message":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"sumPayment":{"anyOf":[{"type":"number","description":"Cents."},{"type":"null"}]},"sumCarriage":{"anyOf":[{"type":"number","description":"Cents."},{"type":"null"}]},"discountFee":{"anyOf":[{"type":"number","description":"Cents."},{"type":"null"}]},"cargoList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"offerId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"specId":{"type":"string","description":""},"quantity":{"type":"integer","description":""},"finalUnitPrice":{"type":"number","description":"CNY yuan."},"amount":{"type":"number","description":"CNY yuan."}},"required":[],"additionalProperties":true}},{"type":"null"}]},"tradeModelList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},{"type":"null"}]},"payChannelInfos":{"anyOf":[{"type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},{"type":"null"}]},"shopPromotionList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"status":true,"sumPayment":840,"sumCarriage":0,"discountFee":0,"cargoList":[{"offerId":"1234567890123456789","quantity":2,"finalUnitPrice":4.2,"amount":8.4}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-alibaba1688-order-preview/run":{"post":{"operationId":"data_alibaba1688_order_preview_run","summary":"1688 Order Preview","description":"Order Preview for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user and an Alipay account bound to that same 1688 buyer account. If 1688 returns BUYER_NOT_BIND_ALIPAY, complete the binding on 1688 before retrying. Procurement responses are live; do not cache or automatically retry writes. Stop on status=false even if the envelope succeeds. Totals are cents; cargo prices are CNY yuan.","x-nexscope-slug":"data-alibaba1688-order-preview","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"addressId":{"type":"string","description":"Select from receiveAddressList."},"addressParam":{"type":"object","properties":{"fullName":{"type":"string","description":"Recipient name."},"mobile":{"type":"string","description":"Recipient phone; avoid sharing outside the request."},"address":{"type":"string","description":"Street address."},"provinceText":{"type":"string","description":""},"cityText":{"type":"string","description":""},"areaText":{"type":"string","description":""},"postCode":{"type":"string","description":"Postal code."},"phone":{"type":"string","description":"Landline phone number."}},"required":["fullName","mobile","address"],"additionalProperties":true},"cargoParamList":{"type":"array","items":{"type":"object","properties":{"offerId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"specId":{"type":"string","description":"SKU specification identifier."},"quantity":{"type":"integer","description":"Quantity in the selling unit.","minimum":1}},"required":["offerId","quantity"],"additionalProperties":true},"minItems":1},"flow":{"type":"string","description":"Order flow; defaults to general when omitted.","enum":["general","fenxiao","boutiquefenxiao"],"default":"general"},"isvBizType":{"type":"string","description":"Cross-border business type.","enum":["cross","cross_daigou","cross_distribution"],"default":"cross"},"useBorderLogisticsSolution":{"type":"boolean","description":"Whether to use a cross-border logistics solution."},"crossBorderLogisticsSolutionId":{"type":"string","description":"Cross-border logistics solution sourceId."},"invoiceParam":{"type":"object","description":"Optional invoice details for order preview.","properties":{"invoiceType":{"type":"integer","description":"0: ordinary invoice; 1: special VAT invoice."},"titleType":{"type":"integer","description":"1: personal; 2: company."},"title":{"type":"string","description":"Invoice title."},"taxpayerNumber":{"type":"string","description":"Taxpayer number."},"bankName":{"type":"string","description":"Bank name."},"bankAccount":{"type":"string","description":"Bank account."},"address":{"type":"string","description":"Registered address."},"phone":{"type":"string","description":"Registered phone number."}},"additionalProperties":true}},"required":["cargoParamList"],"additionalProperties":true,"anyOf":[{"required":["addressId"]},{"required":["addressParam"]}]},"example":{"addressId":"987654321012345678","flow":"general","cargoParamList":[{"offerId":"1234567890123456789","specId":"example-spec","quantity":2}]}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"status":{"anyOf":[{"type":"boolean","description":"false means do not create an order."},{"type":"null"}]},"message":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"sumPayment":{"anyOf":[{"type":"number","description":"Cents."},{"type":"null"}]},"sumCarriage":{"anyOf":[{"type":"number","description":"Cents."},{"type":"null"}]},"discountFee":{"anyOf":[{"type":"number","description":"Cents."},{"type":"null"}]},"cargoList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"offerId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"specId":{"type":"string","description":""},"quantity":{"type":"integer","description":""},"finalUnitPrice":{"type":"number","description":"CNY yuan."},"amount":{"type":"number","description":"CNY yuan."}},"required":[],"additionalProperties":true}},{"type":"null"}]},"tradeModelList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},{"type":"null"}]},"payChannelInfos":{"anyOf":[{"type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},{"type":"null"}]},"shopPromotionList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"status":true,"sumPayment":840,"sumCarriage":0,"discountFee":0,"cargoList":[{"offerId":"1234567890123456789","quantity":2,"finalUnitPrice":4.2,"amount":8.4}]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/alibaba1688/createOrder":{"post":{"operationId":"data_alibaba1688_create_order_public","summary":"1688 Create Order","description":"Create Order for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user and an Alipay account bound to that same 1688 buyer account. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-create-order","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"addressId":{"type":"string","description":"Select from receiveAddressList."},"addressParam":{"type":"object","properties":{"fullName":{"type":"string","description":"Recipient name."},"mobile":{"type":"string","description":"Recipient phone; avoid sharing outside the request."},"address":{"type":"string","description":"Street address."},"provinceText":{"type":"string","description":""},"cityText":{"type":"string","description":""},"areaText":{"type":"string","description":""},"postCode":{"type":"string","description":"Postal code."},"phone":{"type":"string","description":"Landline phone number."}},"required":["fullName","mobile","address"],"additionalProperties":true},"cargoParamList":{"type":"array","items":{"type":"object","properties":{"offerId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"specId":{"type":"string","description":"SKU specification identifier."},"quantity":{"type":"integer","description":"Quantity in the selling unit.","minimum":1}},"required":["offerId","quantity"],"additionalProperties":true},"minItems":1},"flow":{"type":"string","description":"Order flow; defaults to general when omitted.","enum":["general","fenxiao","boutiquefenxiao"],"default":"general"},"isvBizType":{"type":"string","description":"Cross-border business type.","enum":["cross","cross_daigou","cross_distribution"],"default":"cross"},"message":{"type":"string","description":""},"tradeType":{"type":"string","description":"Trade type: assureTrade, alipay, period, assure, creditBuy, bank, 631staged or 37staged."},"shopPromotionId":{"type":"string","description":""},"outOrderId":{"type":"string","description":""},"useRedEnvelope":{"type":"string","description":"","enum":["y","n"],"default":"n"},"anonymousBuyer":{"type":"boolean","description":""},"confirmCreateOrder":{"type":"boolean","description":"Must be JSON true after separate explicit user confirmation. Examples default to false and do not authorize this action.","default":false},"useBorderLogisticsSolution":{"type":"boolean","description":"Whether to use a cross-border logistics solution."},"crossBorderLogisticsSolutionId":{"type":"string","description":"Cross-border logistics solution sourceId."},"fenxiaoChannel":{"type":"string","description":"Distribution platform.","enum":["douyin","kuajing","pinduoduo","taote"]}},"required":["cargoParamList","confirmCreateOrder"],"additionalProperties":true,"anyOf":[{"required":["addressId"]},{"required":["addressParam"]}]},"example":{"addressId":"987654321012345678","flow":"general","cargoParamList":[{"offerId":"1234567890123456789","specId":"example-spec","quantity":2}],"confirmCreateOrder":false}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Inspect this business outcome even when HTTP status is 200."},{"type":"null"}]},"code":{"anyOf":[{"type":"string","description":"Upstream business code."},{"type":"null"}]},"message":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"subCode":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"subMessage":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"orderId":{"anyOf":[{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"success":true,"orderId":"3309156590237728779"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-alibaba1688-create-order/run":{"post":{"operationId":"data_alibaba1688_create_order_run","summary":"1688 Create Order","description":"Create Order for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user and an Alipay account bound to that same 1688 buyer account. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-create-order","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"addressId":{"type":"string","description":"Select from receiveAddressList."},"addressParam":{"type":"object","properties":{"fullName":{"type":"string","description":"Recipient name."},"mobile":{"type":"string","description":"Recipient phone; avoid sharing outside the request."},"address":{"type":"string","description":"Street address."},"provinceText":{"type":"string","description":""},"cityText":{"type":"string","description":""},"areaText":{"type":"string","description":""},"postCode":{"type":"string","description":"Postal code."},"phone":{"type":"string","description":"Landline phone number."}},"required":["fullName","mobile","address"],"additionalProperties":true},"cargoParamList":{"type":"array","items":{"type":"object","properties":{"offerId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"specId":{"type":"string","description":"SKU specification identifier."},"quantity":{"type":"integer","description":"Quantity in the selling unit.","minimum":1}},"required":["offerId","quantity"],"additionalProperties":true},"minItems":1},"flow":{"type":"string","description":"Order flow; defaults to general when omitted.","enum":["general","fenxiao","boutiquefenxiao"],"default":"general"},"isvBizType":{"type":"string","description":"Cross-border business type.","enum":["cross","cross_daigou","cross_distribution"],"default":"cross"},"message":{"type":"string","description":""},"tradeType":{"type":"string","description":"Trade type: assureTrade, alipay, period, assure, creditBuy, bank, 631staged or 37staged."},"shopPromotionId":{"type":"string","description":""},"outOrderId":{"type":"string","description":""},"useRedEnvelope":{"type":"string","description":"","enum":["y","n"],"default":"n"},"anonymousBuyer":{"type":"boolean","description":""},"confirmCreateOrder":{"type":"boolean","description":"Must be JSON true after separate explicit user confirmation. Examples default to false and do not authorize this action.","default":false},"useBorderLogisticsSolution":{"type":"boolean","description":"Whether to use a cross-border logistics solution."},"crossBorderLogisticsSolutionId":{"type":"string","description":"Cross-border logistics solution sourceId."},"fenxiaoChannel":{"type":"string","description":"Distribution platform.","enum":["douyin","kuajing","pinduoduo","taote"]}},"required":["cargoParamList","confirmCreateOrder"],"additionalProperties":true,"anyOf":[{"required":["addressId"]},{"required":["addressParam"]}]},"example":{"addressId":"987654321012345678","flow":"general","cargoParamList":[{"offerId":"1234567890123456789","specId":"example-spec","quantity":2}],"confirmCreateOrder":false}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Inspect this business outcome even when HTTP status is 200."},{"type":"null"}]},"code":{"anyOf":[{"type":"string","description":"Upstream business code."},{"type":"null"}]},"message":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"subCode":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"subMessage":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"orderId":{"anyOf":[{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"success":true,"orderId":"3309156590237728779"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/alibaba1688/paymentUrl":{"post":{"operationId":"data_alibaba1688_payment_url_public","summary":"1688 Payment URL","description":"Payment URL for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes. Returns a payment link only; never opens it or pays automatically.","x-nexscope-slug":"data-alibaba1688-payment-url","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderIdList":{"type":"array","items":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"minItems":1},"confirmGetPaymentUrl":{"type":"boolean","description":"Must be JSON true after separate explicit user confirmation. Examples default to false and do not authorize this action.","default":false}},"required":["orderIdList","confirmGetPaymentUrl"],"additionalProperties":true},"example":{"orderIdList":["3309156590237728779"],"confirmGetPaymentUrl":false}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":""},{"type":"null"}]},"payUrl":{"anyOf":[{"type":"string","description":"Display for manual payment; do not open or pay automatically."},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string","description":""},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"success":true,"payUrl":"https://trade.1688.com/example"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-alibaba1688-payment-url/run":{"post":{"operationId":"data_alibaba1688_payment_url_run","summary":"1688 Payment URL","description":"Payment URL for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes. Returns a payment link only; never opens it or pays automatically.","x-nexscope-slug":"data-alibaba1688-payment-url","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderIdList":{"type":"array","items":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"minItems":1},"confirmGetPaymentUrl":{"type":"boolean","description":"Must be JSON true after separate explicit user confirmation. Examples default to false and do not authorize this action.","default":false}},"required":["orderIdList","confirmGetPaymentUrl"],"additionalProperties":true},"example":{"orderIdList":["3309156590237728779"],"confirmGetPaymentUrl":false}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":""},{"type":"null"}]},"payUrl":{"anyOf":[{"type":"string","description":"Display for manual payment; do not open or pay automatically."},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string","description":""},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"success":true,"payUrl":"https://trade.1688.com/example"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/alibaba1688/orderStatus":{"post":{"operationId":"data_alibaba1688_order_status_public","summary":"1688 Order Status","description":"Order Status for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-order-status","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"aliOrderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"}},"required":["aliOrderId"],"additionalProperties":true},"example":{"aliOrderId":"3309156590237728779"}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"aliOrderId":{"anyOf":[{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},{"type":"null"}]},"aliStatus":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"normalizedStatus":{"anyOf":[{"type":"string","description":""},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"aliOrderId":"3309156590237728779","normalizedStatus":"WAIT_BUYER_PAY"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-alibaba1688-order-status/run":{"post":{"operationId":"data_alibaba1688_order_status_run","summary":"1688 Order Status","description":"Order Status for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-order-status","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"aliOrderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"}},"required":["aliOrderId"],"additionalProperties":true},"example":{"aliOrderId":"3309156590237728779"}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"aliOrderId":{"anyOf":[{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},{"type":"null"}]},"aliStatus":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"normalizedStatus":{"anyOf":[{"type":"string","description":""},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"aliOrderId":"3309156590237728779","normalizedStatus":"WAIT_BUYER_PAY"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/alibaba1688/logistics":{"post":{"operationId":"data_alibaba1688_logistics_public","summary":"1688 Logistics","description":"Logistics for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-logistics","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"aliOrderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"}},"required":["aliOrderId"],"additionalProperties":true},"example":{"aliOrderId":"3309156590237728779"}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"aliOrderId":{"anyOf":[{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},{"type":"null"}]},"logisticsOrders":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"logisticsId":{"type":"string","description":""},"logisticsBillNo":{"type":"string","description":""},"logisticsCompanyName":{"type":"string","description":""},"status":{"type":"string","description":""}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"aliOrderId":"3309156590237728779","logisticsOrders":[]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-alibaba1688-logistics/run":{"post":{"operationId":"data_alibaba1688_logistics_run","summary":"1688 Logistics","description":"Logistics for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-logistics","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"aliOrderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"}},"required":["aliOrderId"],"additionalProperties":true},"example":{"aliOrderId":"3309156590237728779"}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"aliOrderId":{"anyOf":[{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},{"type":"null"}]},"logisticsOrders":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"logisticsId":{"type":"string","description":""},"logisticsBillNo":{"type":"string","description":""},"logisticsCompanyName":{"type":"string","description":""},"status":{"type":"string","description":""}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"aliOrderId":"3309156590237728779","logisticsOrders":[]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/alibaba1688/logisticsTrace":{"post":{"operationId":"data_alibaba1688_logistics_trace_public","summary":"1688 Logistics Trace","description":"Logistics Trace for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-logistics-trace","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"aliOrderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"logisticsId":{"type":"string","description":"Select a logistics order when multiple shipments exist."}},"required":["aliOrderId"],"additionalProperties":true},"example":{"aliOrderId":"3309156590237728779"}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"aliOrderId":{"anyOf":[{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},{"type":"null"}]},"logisticsId":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"traceList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"traceTime":{"type":"string","description":"Asia/Shanghai time."},"location":{"type":"string","description":""},"traceDescription":{"type":"string","description":""},"traceStatus":{"type":"string","description":""}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"aliOrderId":"3309156590237728779","traceList":[]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-alibaba1688-logistics-trace/run":{"post":{"operationId":"data_alibaba1688_logistics_trace_run","summary":"1688 Logistics Trace","description":"Logistics Trace for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-logistics-trace","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"aliOrderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"logisticsId":{"type":"string","description":"Select a logistics order when multiple shipments exist."}},"required":["aliOrderId"],"additionalProperties":true},"example":{"aliOrderId":"3309156590237728779"}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"aliOrderId":{"anyOf":[{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},{"type":"null"}]},"logisticsId":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"traceList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"traceTime":{"type":"string","description":"Asia/Shanghai time."},"location":{"type":"string","description":""},"traceDescription":{"type":"string","description":""},"traceStatus":{"type":"string","description":""}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"aliOrderId":"3309156590237728779","traceList":[]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/alibaba1688/confirmReceive":{"post":{"operationId":"data_alibaba1688_confirm_receive_public","summary":"1688 Confirm Receive","description":"Confirm Receive for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-confirm-receive","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"aliOrderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"confirmReceive":{"type":"boolean","description":"Must be JSON true after separate explicit user confirmation. Examples default to false and do not authorize this action.","default":false}},"required":["aliOrderId","confirmReceive"],"additionalProperties":true},"example":{"aliOrderId":"3309156590237728779","confirmReceive":false}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":""},{"type":"null"}]},"aliOrderId":{"anyOf":[{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"success":true,"aliOrderId":"3309156590237728779"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-alibaba1688-confirm-receive/run":{"post":{"operationId":"data_alibaba1688_confirm_receive_run","summary":"1688 Confirm Receive","description":"Confirm Receive for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-confirm-receive","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"aliOrderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"confirmReceive":{"type":"boolean","description":"Must be JSON true after separate explicit user confirmation. Examples default to false and do not authorize this action.","default":false}},"required":["aliOrderId","confirmReceive"],"additionalProperties":true},"example":{"aliOrderId":"3309156590237728779","confirmReceive":false}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":""},{"type":"null"}]},"aliOrderId":{"anyOf":[{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"success":true,"aliOrderId":"3309156590237728779"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/alibaba1688/cancelOrder":{"post":{"operationId":"data_alibaba1688_cancel_order_public","summary":"1688 Cancel Order","description":"Cancel Order for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes. Cancellation is not a refund. Eligibility depends on the current 1688 order state.","x-nexscope-slug":"data-alibaba1688-cancel-order","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"aliOrderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"cancelReason":{"type":"string","description":""},"remark":{"type":"string","description":""},"confirmCancel":{"type":"boolean","description":"Must be JSON true after separate explicit user confirmation. Examples default to false and do not authorize this action.","default":false}},"required":["aliOrderId","confirmCancel"],"additionalProperties":true},"example":{"aliOrderId":"3309156590237728779","confirmCancel":false}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":""},{"type":"null"}]},"aliOrderId":{"anyOf":[{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},{"type":"null"}]},"orderId":{"anyOf":[{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},{"type":"null"}]},"message":{"anyOf":[{"type":"string","description":"Cancellation is not a refund or after-sales application."},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"success":true,"aliOrderId":"3309156590237728779"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-alibaba1688-cancel-order/run":{"post":{"operationId":"data_alibaba1688_cancel_order_run","summary":"1688 Cancel Order","description":"Cancel Order for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes. Cancellation is not a refund. Eligibility depends on the current 1688 order state.","x-nexscope-slug":"data-alibaba1688-cancel-order","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"aliOrderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"cancelReason":{"type":"string","description":""},"remark":{"type":"string","description":""},"confirmCancel":{"type":"boolean","description":"Must be JSON true after separate explicit user confirmation. Examples default to false and do not authorize this action.","default":false}},"required":["aliOrderId","confirmCancel"],"additionalProperties":true},"example":{"aliOrderId":"3309156590237728779","confirmCancel":false}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":""},{"type":"null"}]},"aliOrderId":{"anyOf":[{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},{"type":"null"}]},"orderId":{"anyOf":[{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},{"type":"null"}]},"message":{"anyOf":[{"type":"string","description":"Cancellation is not a refund or after-sales application."},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"success":true,"aliOrderId":"3309156590237728779"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/alibaba1688/invoiceAmount":{"post":{"operationId":"data_alibaba1688_invoice_amount_public","summary":"1688 Invoice Amount","description":"Invoice Amount for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-invoice-amount","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderIds":{"type":"array","items":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"minItems":1}},"required":["orderIds"],"additionalProperties":true},"example":{"orderIds":["3309156590237728779"]}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Inspect this business outcome even when HTTP status is 200."},{"type":"null"}]},"code":{"anyOf":[{"type":"string","description":"Upstream business code."},{"type":"null"}]},"message":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"subCode":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"subMessage":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"retCodes":{"anyOf":[{"type":"array","items":{}},{"type":"null"}]},"orderInvoiceAmountModelList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"orderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"amount":{"type":"number","description":"Cents; copy unchanged into invoiceApply."}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"success":true,"orderInvoiceAmountModelList":[{"orderId":"3309156590237728779","amount":840}],"retCodes":["SUCCESS"]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-alibaba1688-invoice-amount/run":{"post":{"operationId":"data_alibaba1688_invoice_amount_run","summary":"1688 Invoice Amount","description":"Invoice Amount for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes.","x-nexscope-slug":"data-alibaba1688-invoice-amount","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderIds":{"type":"array","items":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"minItems":1}},"required":["orderIds"],"additionalProperties":true},"example":{"orderIds":["3309156590237728779"]}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Inspect this business outcome even when HTTP status is 200."},{"type":"null"}]},"code":{"anyOf":[{"type":"string","description":"Upstream business code."},{"type":"null"}]},"message":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"subCode":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"subMessage":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"retCodes":{"anyOf":[{"type":"array","items":{}},{"type":"null"}]},"orderInvoiceAmountModelList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"orderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"amount":{"type":"number","description":"Cents; copy unchanged into invoiceApply."}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"success":true,"orderInvoiceAmountModelList":[{"orderId":"3309156590237728779","amount":840}],"retCodes":["SUCCESS"]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/alibaba1688/invoiceApply":{"post":{"operationId":"data_alibaba1688_invoice_apply_public","summary":"1688 Invoice Apply","description":"Invoice Apply for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes. Inspect every successList and failedList item. INVOICE_ALREADY_APPLIED means already invoiced. Issued invoices cannot be rolled back here.","x-nexscope-slug":"data-alibaba1688-invoice-apply","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"invoiceApplyModelList":{"type":"array","items":{"type":"object","properties":{"orderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"amount":{"type":"integer","description":"Positive integer cents copied unchanged from invoiceAmount (64-bit integer).","minimum":1,"maximum":9223372036854775807},"invoiceType":{"type":"string","description":"","enum":["VATAX_COMM","VATAX_SPEC"]},"purchaserInvoiceTitleModel":{"type":"object","properties":{"titleType":{"type":"string","description":"","enum":["PERSONAL","COMPANY"]},"title":{"type":"string","description":""},"taxpayerIdentify":{"type":"string","description":"Required for all COMPANY titles."},"bankName":{"type":"string","description":"Required for COMPANY titles with VATAX_SPEC."},"bankAccountId":{"type":"string","description":"Required for COMPANY titles with VATAX_SPEC."},"registerAddress":{"type":"string","description":"Required for COMPANY titles with VATAX_SPEC."},"registerPhone":{"type":"string","description":"Required for COMPANY titles with VATAX_SPEC."}},"required":["titleType","title"],"additionalProperties":true,"allOf":[{"if":{"properties":{"titleType":{"const":"COMPANY"}},"required":["titleType"]},"then":{"required":["taxpayerIdentify"]}}],"description":"COMPANY requires taxpayerIdentify. COMPANY with VATAX_SPEC also requires bankName, bankAccountId, registerAddress and registerPhone."}},"required":["orderId","amount","invoiceType","purchaserInvoiceTitleModel"],"additionalProperties":true,"allOf":[{"if":{"properties":{"invoiceType":{"const":"VATAX_SPEC"},"purchaserInvoiceTitleModel":{"properties":{"titleType":{"const":"COMPANY"}},"required":["titleType"]}},"required":["invoiceType","purchaserInvoiceTitleModel"]},"then":{"properties":{"purchaserInvoiceTitleModel":{"required":["bankName","bankAccountId","registerAddress","registerPhone"]}}}}]},"minItems":1},"confirmApplyInvoice":{"type":"boolean","description":"Must be JSON true after separate explicit user confirmation. Examples default to false and do not authorize this action.","default":false}},"required":["invoiceApplyModelList","confirmApplyInvoice"],"additionalProperties":true},"example":{"invoiceApplyModelList":[{"orderId":"3309156590237728779","amount":840,"invoiceType":"VATAX_COMM","purchaserInvoiceTitleModel":{"titleType":"PERSONAL","title":"Example recipient"}}],"confirmApplyInvoice":false}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Inspect this business outcome even when HTTP status is 200."},{"type":"null"}]},"code":{"anyOf":[{"type":"string","description":"Upstream business code."},{"type":"null"}]},"message":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"subCode":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"subMessage":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"successList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"orderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"outBizId":{"type":"string","description":""},"result":{"type":"string","description":""},"tradeOrderCompleted":{"type":"boolean","description":""},"errorCode":{"type":"string","description":""},"errorDesc":{"type":"string","description":""}},"required":[],"additionalProperties":true}},{"type":"null"}]},"failedList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"orderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"outBizId":{"type":"string","description":""},"result":{"type":"string","description":""},"tradeOrderCompleted":{"type":"boolean","description":""},"errorCode":{"type":"string","description":""},"errorDesc":{"type":"string","description":""}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"success":true,"successList":[{"orderId":"3309156590237728779","result":"SUCCESS"}],"failedList":[]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/skills/data-alibaba1688-invoice-apply/run":{"post":{"operationId":"data_alibaba1688_invoice_apply_run","summary":"1688 Invoice Apply","description":"Invoice Apply for the currently authenticated Nexscope user. Use your Nexscope API key. Requires an ACTIVE, unexpired 1688 authorization owned by the current user. Procurement responses are live; do not cache or automatically retry writes. Inspect every successList and failedList item. INVOICE_ALREADY_APPLIED means already invoiced. Issued invoices cannot be rolled back here.","x-nexscope-slug":"data-alibaba1688-invoice-apply","tags":["1688"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"invoiceApplyModelList":{"type":"array","items":{"type":"object","properties":{"orderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"amount":{"type":"integer","description":"Positive integer cents copied unchanged from invoiceAmount (64-bit integer).","minimum":1,"maximum":9223372036854775807},"invoiceType":{"type":"string","description":"","enum":["VATAX_COMM","VATAX_SPEC"]},"purchaserInvoiceTitleModel":{"type":"object","properties":{"titleType":{"type":"string","description":"","enum":["PERSONAL","COMPANY"]},"title":{"type":"string","description":""},"taxpayerIdentify":{"type":"string","description":"Required for all COMPANY titles."},"bankName":{"type":"string","description":"Required for COMPANY titles with VATAX_SPEC."},"bankAccountId":{"type":"string","description":"Required for COMPANY titles with VATAX_SPEC."},"registerAddress":{"type":"string","description":"Required for COMPANY titles with VATAX_SPEC."},"registerPhone":{"type":"string","description":"Required for COMPANY titles with VATAX_SPEC."}},"required":["titleType","title"],"additionalProperties":true,"allOf":[{"if":{"properties":{"titleType":{"const":"COMPANY"}},"required":["titleType"]},"then":{"required":["taxpayerIdentify"]}}],"description":"COMPANY requires taxpayerIdentify. COMPANY with VATAX_SPEC also requires bankName, bankAccountId, registerAddress and registerPhone."}},"required":["orderId","amount","invoiceType","purchaserInvoiceTitleModel"],"additionalProperties":true,"allOf":[{"if":{"properties":{"invoiceType":{"const":"VATAX_SPEC"},"purchaserInvoiceTitleModel":{"properties":{"titleType":{"const":"COMPANY"}},"required":["titleType"]}},"required":["invoiceType","purchaserInvoiceTitleModel"]},"then":{"properties":{"purchaserInvoiceTitleModel":{"required":["bankName","bankAccountId","registerAddress","registerPhone"]}}}}]},"minItems":1},"confirmApplyInvoice":{"type":"boolean","description":"Must be JSON true after separate explicit user confirmation. Examples default to false and do not authorize this action.","default":false}},"required":["invoiceApplyModelList","confirmApplyInvoice"],"additionalProperties":true},"example":{"invoiceApplyModelList":[{"orderId":"3309156590237728779","amount":840,"invoiceType":"VATAX_COMM","purchaserInvoiceTitleModel":{"titleType":"PERSONAL","title":"Example recipient"}}],"confirmApplyInvoice":false}}}},"responses":{"200":{"description":"Inspect code and data. A processed request does not imply a successful procurement operation.","content":{"application/json":{"schema":{"type":"object","required":["code","msg","data","ts","time","cost","traceId"],"properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Inspect this business outcome even when HTTP status is 200."},{"type":"null"}]},"code":{"anyOf":[{"type":"string","description":"Upstream business code."},{"type":"null"}]},"message":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"subCode":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"subMessage":{"anyOf":[{"type":"string","description":""},{"type":"null"}]},"successList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"orderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"outBizId":{"type":"string","description":""},"result":{"type":"string","description":""},"tradeOrderCompleted":{"type":"boolean","description":""},"errorCode":{"type":"string","description":""},"errorDesc":{"type":"string","description":""}},"required":[],"additionalProperties":true}},{"type":"null"}]},"failedList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"orderId":{"type":"string","description":"Exact positive integer identifier. Send as a JSON string.","pattern":"^[1-9][0-9]*$"},"outBizId":{"type":"string","description":""},"result":{"type":"string","description":""},"tradeOrderCompleted":{"type":"boolean","description":""},"errorCode":{"type":"string","description":""},"errorDesc":{"type":"string","description":""}},"required":[],"additionalProperties":true}},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"success":true,"successList":[{"orderId":"3309156590237728779","result":"SUCCESS"}],"failedList":[]},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"409":{"$ref":"#/components/responses/SkillApiSemanticError"},"410":{"$ref":"#/components/responses/SkillApiSemanticError"},"413":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/aliexpress/productSearch":{"post":{"operationId":"aliexpressProductSearch","summary":"Search AliExpress products by keyword.","x-nexscope-slug":"aliexpress-product-search","tags":["AliExpress"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"keyword":{"type":"string","minLength":1,"maxLength":120,"description":"Search keyword."},"pageNum":{"type":"integer","minimum":1,"maximum":20,"default":1},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20}},"required":["keyword"]},"example":{"keyword":"wireless earbuds","pageNum":1,"limit":1}}}},"responses":{"200":{"description":"Inspect code and data; an accepted task may still be running.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]},"data":{"type":"object","properties":{"taskId":{"type":"string"},"status":{"type":"string"},"result":{"type":["object","null"],"additionalProperties":true},"usage":{"type":["object","null"],"additionalProperties":true},"error":{"type":["string","null"]}},"required":["taskId","status"]}},"required":["code"]}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/aliexpress/productDetail":{"post":{"operationId":"aliexpressProductDetail","summary":"Collect a public AliExpress product detail page.","x-nexscope-slug":"aliexpress-product-detail","tags":["AliExpress"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"AliExpress product detail URL ending in /item/{id}.html."}},"required":["url"]},"example":{"url":"https://www.aliexpress.us/item/1005008144724922.html"}}}},"responses":{"200":{"description":"Inspect code and data; an accepted task may still be running.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]},"data":{"type":"object","properties":{"taskId":{"type":"string"},"status":{"type":"string"},"result":{"type":["object","null"],"additionalProperties":true},"usage":{"type":["object","null"],"additionalProperties":true},"error":{"type":["string","null"]}},"required":["taskId","status"]}},"required":["code"]}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/aliexpress/categoryProducts":{"post":{"operationId":"aliexpressCategoryProducts","summary":"Discover products from a public AliExpress category URL.","x-nexscope-slug":"aliexpress-category-products","tags":["AliExpress"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"Supported AliExpress category navigation URL."},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20}},"required":["url"]},"example":{"url":"https://www.aliexpress.com/w/wholesale-Magic-Tricks-%26-Props.html?&osf=category_navigate&sg_search_params=scene_id=35917&recog_lang=en","limit":1}}}},"responses":{"200":{"description":"Inspect code and data; an accepted task may still be running.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]},"data":{"type":"object","properties":{"taskId":{"type":"string"},"status":{"type":"string"},"result":{"type":["object","null"],"additionalProperties":true},"usage":{"type":["object","null"],"additionalProperties":true},"error":{"type":["string","null"]}},"required":["taskId","status"]}},"required":["code"]}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/aliexpress/categoryVariants":{"post":{"operationId":"aliexpressCategoryVariants","summary":"Collect observed variants through AliExpress category discovery.","x-nexscope-slug":"aliexpress-category-variants","tags":["AliExpress"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"Supported AliExpress category navigation URL."},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20}},"required":["url"]},"example":{"url":"https://www.aliexpress.com/w/wholesale-Magic-Tricks-%26-Props.html?&osf=category_navigate&sg_search_params=scene_id=35917&recog_lang=en","limit":1}}}},"responses":{"200":{"description":"Inspect code and data; an accepted task may still be running.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]},"data":{"type":"object","properties":{"taskId":{"type":"string"},"status":{"type":"string"},"result":{"type":["object","null"],"additionalProperties":true},"usage":{"type":["object","null"],"additionalProperties":true},"error":{"type":["string","null"]}},"required":["taskId","status"]}},"required":["code"]}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/aliexpress/googleOrganicSearch":{"post":{"operationId":"aliexpressGoogleOrganicSearch","summary":"Search Google organic results for AliExpress research.","x-nexscope-slug":"aliexpress-google-organic-search","tags":["AliExpress"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"requestId":{"type":"string","format":"uuid"},"keyword":{"type":"string","minLength":1,"maxLength":120,"description":"Search keyword."},"pageNum":{"type":"integer","minimum":1,"maximum":10,"default":1},"limit":{"type":"integer","minimum":1,"maximum":10,"default":10}},"required":["requestId","keyword"]},"example":{"requestId":"11111111-1111-4111-8111-111111111111","keyword":"wireless earbuds","pageNum":1,"limit":1}}}},"responses":{"200":{"description":"Inspect code and data; an accepted task may still be running.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]},"data":{"type":"object","properties":{"taskId":{"type":"string"},"status":{"type":"string"},"result":{"type":["object","null"],"additionalProperties":true},"usage":{"type":["object","null"],"additionalProperties":true},"error":{"type":["string","null"]}},"required":["taskId","status"]}},"required":["code"]}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/aliexpress/pageRead":{"post":{"operationId":"aliexpressPageRead","summary":"Read a bounded public AliExpress page.","x-nexscope-slug":"aliexpress-page-read","tags":["AliExpress"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"requestId":{"type":"string","format":"uuid"},"keyword":{"type":"string","minLength":1,"maxLength":120,"description":"Search keyword."},"pageNum":{"type":"integer","minimum":1,"maximum":20,"default":1}},"required":["requestId","keyword"]},{"type":"object","additionalProperties":false,"properties":{"requestId":{"type":"string","format":"uuid"},"url":{"type":"string","format":"uri","description":"Supported public AliExpress page URL."}},"required":["requestId","url"]}]},"example":{"requestId":"11111111-1111-4111-8111-111111111111","keyword":"wireless earbuds","pageNum":1}}}},"responses":{"200":{"description":"Inspect code and data; an accepted task may still be running.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]},"data":{"type":"object","properties":{"taskId":{"type":"string"},"status":{"type":"string"},"result":{"type":["object","null"],"additionalProperties":true},"usage":{"type":["object","null"],"additionalProperties":true},"error":{"type":["string","null"]}},"required":["taskId","status"]}},"required":["code"]}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/aliexpress/tasks/{taskId}":{"get":{"operationId":"aliexpressTaskResult","summary":"Read an AliExpress collection task.","x-nexscope-shared-result-for":["aliexpress-product-search","aliexpress-product-detail","aliexpress-category-products","aliexpress-category-variants"],"tags":["AliExpress"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"taskId","in":"path","required":true,"schema":{"type":"string"},"description":"Task ID from the corresponding submission response."}],"responses":{"200":{"description":"Return the current task status and final result when available.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]},"data":{"type":"object","properties":{"taskId":{"type":"string"},"status":{"type":"string"},"result":{"type":["object","null"],"additionalProperties":true},"usage":{"type":["object","null"],"additionalProperties":true},"error":{"type":["string","null"]}},"required":["taskId","status"]}},"required":["code"]}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/aliexpress/accessTasks/{taskId}":{"get":{"operationId":"aliexpressAccessTaskResult","summary":"Read an AliExpress access task.","x-nexscope-shared-result-for":["aliexpress-google-organic-search","aliexpress-page-read"],"tags":["AliExpress"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"taskId","in":"path","required":true,"schema":{"type":"string"},"description":"Task ID from the corresponding submission response."}],"responses":{"200":{"description":"Return the current task status and final result when available.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]},"data":{"type":"object","properties":{"taskId":{"type":"string"},"status":{"type":"string"},"result":{"type":["object","null"],"additionalProperties":true},"usage":{"type":["object","null"],"additionalProperties":true},"error":{"type":["string","null"]}},"required":["taskId","status"]}},"required":["code"]}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/account/credits":{"get":{"operationId":"accountCredits","summary":"Read account credit balance and settled consumption.","x-nexscope-slug":"account-credits","tags":["Account"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"startTime","in":"query","required":false,"description":"Inclusive UTC epoch milliseconds.","schema":{"type":"string","pattern":"^[0-9]+$"}},{"name":"endTime","in":"query","required":false,"description":"Exclusive UTC epoch milliseconds.","schema":{"type":"string","pattern":"^[0-9]+$"}}],"responses":{"200":{"description":"Return committed account records without creating a billable provider call.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]},"data":{"type":"object","additionalProperties":true,"properties":{"scope":{"type":"string"},"observedAt":{"type":"string"},"startTime":{"type":"string"},"endTime":{"type":"string"},"permanentCredit":{"type":"string"},"cycleCredit":{"type":"string"},"debt":{"type":"string"},"netCredit":{"type":"string"},"grossConsumedCredit":{"type":"string"},"quota":{"type":"null"}}}},"required":["code"]}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/account/usage":{"get":{"operationId":"accountUsage","summary":"Read API key business call usage.","x-nexscope-slug":"account-usage","tags":["Account"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"startTime","in":"query","required":false,"description":"Inclusive UTC epoch milliseconds.","schema":{"type":"string","pattern":"^[0-9]+$"}},{"name":"endTime","in":"query","required":false,"description":"Exclusive UTC epoch milliseconds.","schema":{"type":"string","pattern":"^[0-9]+$"}},{"name":"pageNum","in":"query","required":false,"description":"One-based page number.","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","required":false,"description":"Rows per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"Return committed account records without creating a billable provider call.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]},"data":{"type":"object","additionalProperties":true,"properties":{"scope":{"type":"string"},"observedAt":{"type":"string"},"startTime":{"type":"string"},"endTime":{"type":"string"},"grossChargedCredit":{"type":"string"},"calls":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","additionalProperties":true}},"total":{"type":"string"},"size":{"type":"string"},"current":{"type":"string"},"pages":{"type":"string"}}}}}},"required":["code"]}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/jev/route":{"post":{"operationId":"jevRoute","summary":"Route an intent to a published API.","x-nexscope-slug":"jev-route","tags":["JEV"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"categorySlug":{"type":"string","maxLength":128,"minLength":1},"intent":{"type":"string","maxLength":2000,"minLength":1}},"additionalProperties":false,"type":"object","required":["intent"]},"example":{"intent":"Find product opportunities on Amazon."}}}},"responses":{"200":{"description":"Inspect code and data; an accepted task may still be running.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]},"data":{"type":"object","properties":{"status":{"type":"string"},"catalogVersion":{"type":"string"},"policyVersion":{"type":"string"},"models":{"type":"array","items":{"type":"string"}},"confidence":{"type":["number","null"]},"match":{"type":["object","null"],"additionalProperties":true},"candidates":{"type":"array","items":{"type":"object","additionalProperties":true}},"reason":{"type":["string","null"]}}}},"required":["code"]}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/api/skill-api/v1/jev/evaluate":{"post":{"operationId":"jevEvaluate","summary":"Evaluate text with a fixed JEV use case.","x-nexscope-slug":"jev-evaluate","tags":["JEV"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"input":{"type":"object"},"state":{"type":["string","object","array"],"minLength":1,"minItems":1,"minProperties":1},"useCase":{"enum":["response_guardrails","ip_risk_triage","seo_relevance","evidence_check","keyword_business_relevance","keyword_cluster_fit","amazon_keyword_product_fit"],"type":"string"},"questions":{"propertyNames":{"pattern":"^[A-Za-z0-9_-]{1,64}$","type":"string"},"type":"object","maxProperties":32,"additionalProperties":{"oneOf":[{"properties":{"instructions":{"type":"string","maxLength":4000,"minLength":1},"criteria":{"properties":{"false":{"type":"string","maxLength":2000,"minLength":1},"true":{"type":"string","maxLength":2000,"minLength":1}},"additionalProperties":false,"type":"object","required":[]},"type":{"const":"noul"}},"additionalProperties":false,"type":"object","required":["type","instructions"]},{"properties":{"instructions":{"type":"string","maxLength":4000,"minLength":1},"criteria":{"propertyNames":{"pattern":"^[A-Za-z0-9_-]{1,64}$","type":"string"},"type":"object","maxProperties":255,"additionalProperties":{"type":["string","null"],"maxLength":2000,"minLength":1},"minProperties":2},"type":{"const":"choice"}},"additionalProperties":false,"type":"object","required":["type","instructions","criteria"]},{"properties":{"instructions":{"type":"string","maxLength":4000,"minLength":1},"criteria":{"maxItems":32,"type":"array","items":{"type":"string","maxLength":2000,"minLength":1},"minItems":2},"type":{"const":"score"}},"additionalProperties":false,"type":"object","required":["type","instructions","criteria"]}]},"minProperties":1}},"additionalProperties":false,"type":"object","oneOf":[{"not":{"anyOf":[{"required":["state"]},{"required":["questions"]}]},"oneOf":[{"properties":{"useCase":{"const":"response_guardrails"},"input":{"properties":{"content":{"type":"string","maxLength":6000,"minLength":1}},"additionalProperties":false,"type":"object","required":["content"]}}},{"properties":{"useCase":{"const":"ip_risk_triage"},"input":{"properties":{"text":{"type":"string","maxLength":4000,"minLength":1}},"additionalProperties":false,"type":"object","required":["text"]}}},{"properties":{"useCase":{"const":"seo_relevance"},"input":{"properties":{"contentExcerpt":{"type":"string","maxLength":4000,"minLength":1},"title":{"type":"string","maxLength":300,"minLength":1},"query":{"type":"string","maxLength":500,"minLength":1},"metaDescription":{"type":"string","maxLength":1000,"minLength":1}},"additionalProperties":false,"type":"object","required":["query"]}}},{"properties":{"useCase":{"const":"evidence_check"},"input":{"properties":{"sourceText":{"type":"string","maxLength":6000,"minLength":1},"claim":{"type":"string","maxLength":1000,"minLength":1},"quote":{"type":"string","maxLength":1000,"minLength":1}},"additionalProperties":false,"type":"object","required":["claim","sourceText"]}}},{"properties":{"useCase":{"const":"keyword_business_relevance"},"input":{"properties":{"businessDescription":{"type":"string","maxLength":4000,"minLength":1},"keywords":{"maxItems":10,"type":"array","items":{"properties":{"keyword":{"type":"string","maxLength":500,"minLength":1},"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","type":"string"}},"additionalProperties":false,"type":"object","required":["id","keyword"]},"minItems":1},"serpEvidence":{"maxItems":30,"type":"array","items":{"properties":{"keywordId":{"pattern":"^[A-Za-z0-9_-]{1,64}$","type":"string"},"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","type":"string"},"text":{"type":"string","maxLength":2000,"minLength":1},"source":{"type":"string","maxLength":200,"minLength":1}},"additionalProperties":false,"type":"object","required":["id","keywordId","source","text"]},"minItems":0},"exclusions":{"maxItems":50,"type":"array","items":{"type":"string","maxLength":200,"minLength":1},"minItems":0}},"additionalProperties":false,"type":"object","required":["businessDescription","exclusions","keywords"]}}},{"properties":{"useCase":{"const":"keyword_cluster_fit"},"input":{"properties":{"candidates":{"maxItems":5,"type":"array","items":{"properties":{"keyword":{"type":"string","maxLength":500,"minLength":1},"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","type":"string"}},"additionalProperties":false,"type":"object","required":["id","keyword"]},"minItems":1},"keywords":{"maxItems":10,"type":"array","items":{"properties":{"keyword":{"type":"string","maxLength":500,"minLength":1},"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","type":"string"}},"additionalProperties":false,"type":"object","required":["id","keyword"]},"minItems":1}},"additionalProperties":false,"type":"object","required":["keywords","candidates"]}}},{"properties":{"useCase":{"const":"amazon_keyword_product_fit"},"input":{"properties":{"marketplace":{"enum":["US","UK","DE","FR","JP","CA","IT","ES","MX","IN"],"type":"string"},"productFacts":{"maxItems":30,"type":"array","items":{"properties":{"value":{"type":"string","maxLength":2000,"minLength":1},"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","type":"string"},"source":{"enum":["title","bullet","attribute","description"],"type":"string"}},"additionalProperties":false,"type":"object","required":["id","source","value"]},"minItems":1},"keywords":{"maxItems":10,"type":"array","items":{"properties":{"keyword":{"type":"string","maxLength":500,"minLength":1},"id":{"pattern":"^[A-Za-z0-9_-]{1,64}$","type":"string"}},"additionalProperties":false,"type":"object","required":["id","keyword"]},"minItems":1}},"additionalProperties":false,"type":"object","required":["marketplace","productFacts","keywords"]}}}],"required":["useCase","input"]},{"not":{"anyOf":[{"required":["useCase"]},{"required":["input"]}]},"required":["state","questions"]}]},"example":{"useCase":"response_guardrails","input":{"content":"Review this response for policy issues."}}}}},"responses":{"200":{"description":"Inspect code and data; an accepted task may still be running.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer"},"msg":{"type":["string","null"]},"ts":{"type":"string"},"time":{"type":"string"},"cost":{"type":"string"},"traceId":{"type":["string","null"]},"data":{"type":"object","properties":{"useCase":{"type":"string"},"policyVersion":{"type":"string"},"model":{"type":"string"},"decision":{"type":"string"},"reasonCodes":{"type":"array","items":{"type":"string"}},"checks":{"type":"object","additionalProperties":true},"result":{"type":"object","additionalProperties":true}}}},"required":["code"]}}}},"400":{"$ref":"#/components/responses/SkillApiSemanticError"},"401":{"$ref":"#/components/responses/SkillApiSemanticError"},"402":{"$ref":"#/components/responses/SkillApiSemanticError"},"403":{"$ref":"#/components/responses/SkillApiSemanticError"},"404":{"$ref":"#/components/responses/SkillApiSemanticError"},"429":{"$ref":"#/components/responses/SkillApiSemanticError"},"500":{"$ref":"#/components/responses/SkillApiSemanticError"},"502":{"$ref":"#/components/responses/SkillApiSemanticError"},"503":{"$ref":"#/components/responses/SkillApiSemanticError"},"504":{"$ref":"#/components/responses/SkillApiSemanticError"}}}},"/amazonAds/authorizedStores":{"post":{"operationId":"nexscope_data_amazon_ads_authorized_stores","x-nexscope-slug":"data-amazon-ads-authorized-stores","summary":"Amazon Ads: authorized Stores API","description":"Amazon Ads: authorized Stores API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":true},"example":{}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"The number of authorized sites returned.","example":null},{"type":"null"}]},"stores[]":{"type":"array","description":"Account × site authorization record.","example":null},"profileId":{"anyOf":[{"type":"number","description":"The profile ID used by downstream ad operations.","example":null},{"type":"null"}]},"accountInfoId":{"anyOf":[{"type":"string","description":"Advertiser entity identifier.","example":null},{"type":"null"}]},"accountInfoName":{"anyOf":[{"type":"string","description":"Store/advertiser name.","example":null},{"type":"null"}]},"accountType":{"anyOf":[{"type":"string","description":"`seller`, `vendor` or `agency`.","example":null},{"type":"null"}]},"countryCode":{"anyOf":[{"type":"string","description":"Site country code.","example":null},{"type":"null"}]},"marketplaceStringId":{"anyOf":[{"type":"string","description":"Amazon marketplace ID。","example":null},{"type":"null"}]},"region":{"anyOf":[{"type":"string","description":"`NA`, `EU` or `FE`.","example":null},{"type":"null"}]},"authRecordId":{"anyOf":[{"type":"number","description":"Authorization record ID.","example":null},{"type":"null"}]},"accountName":{"anyOf":[{"type":"string","description":"The account display name set during authorization.","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/profiles":{"post":{"operationId":"nexscope_data_amazon_ads_profiles","x-nexscope-slug":"data-amazon-ads-profiles","summary":"Amazon Ads: profiles API","description":"Amazon Ads: profiles API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."}},"required":["connectionId"],"additionalProperties":true},"example":{"refresh":false,"connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"number of profiles.","example":null},{"type":"null"}]},"refreshed":{"anyOf":[{"type":"boolean","description":"Whether an upstream refresh was performed.","example":null},{"type":"null"}]},"profiles[]":{"type":"array","description":"profile records.","example":null},"profileId":{"anyOf":[{"type":"number","description":"Ad operation unit ID.","example":null},{"type":"null"}]},"region":{"anyOf":[{"type":"string","description":"`NA`, `EU` or `FE`.","example":null},{"type":"null"}]},"countryCode":{"anyOf":[{"type":"string","description":"Site country code.","example":null},{"type":"null"}]},"currencyCode":{"anyOf":[{"type":"string","description":"Account currency.","example":null},{"type":"null"}]},"dailyBudget":{"anyOf":[{"type":"string","description":"Daily budget.","example":null},{"type":"null"}]},"timezone":{"anyOf":[{"type":"string","description":"Account time zone.","example":null},{"type":"null"}]},"accountInfoId":{"anyOf":[{"type":"string","description":"Advertiser entity identifier.","example":null},{"type":"null"}]},"accountInfoType":{"anyOf":[{"type":"string","description":"Account type.","example":null},{"type":"null"}]},"accountInfoName":{"anyOf":[{"type":"string","description":"Store/advertiser name.","example":null},{"type":"null"}]},"marketplaceStringId":{"anyOf":[{"type":"string","description":"Amazon marketplace ID。","example":null},{"type":"null"}]},"authRecordId":{"anyOf":[{"type":"number","description":"Authorization record ID.","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/refreshToken":{"post":{"operationId":"nexscope_data_amazon_ads_refresh_token","x-nexscope-slug":"data-amazon-ads-refresh-token","summary":"Amazon Ads: refresh Token API","description":"Amazon Ads: refresh Token API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."}},"required":["connectionId"],"additionalProperties":true},"example":{"connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"authRecordId":{"anyOf":[{"type":"number","description":"Authorization record ID.","example":null},{"type":"null"}]},"tokenType":{"anyOf":[{"type":"string","description":"Token type, typically `bearer`.","example":null},{"type":"null"}]},"expiresIn":{"anyOf":[{"type":"string","description":"Access token validity period, usually about 3600 seconds.","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/storeTokens":{"post":{"operationId":"nexscope_data_amazon_ads_store_tokens","x-nexscope-slug":"data-amazon-ads-store-tokens","summary":"Amazon Ads: store Tokens API","description":"Amazon Ads: store Tokens API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."}},"required":["connectionId"],"additionalProperties":true},"example":{"connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"authRecordId":{"anyOf":[{"type":"number","description":"Authorization record ID.","example":null},{"type":"null"}]},"tokenType":{"anyOf":[{"type":"string","description":"Token type, typically `bearer`.","example":null},{"type":"null"}]},"expiresIn":{"anyOf":[{"type":"string","description":"Access token validity period, usually about 3600 seconds.","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sp/campaigns":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sp_campaigns","x-nexscope-slug":"data-amazon-ads-developer-proxy-sp-campaigns","summary":"Amazon Ads: sp/campaigns API","description":"Amazon Ads: sp/campaigns API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: `POST` creation, `PUT` modification."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/vnd.spCampaign.v3+json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.spCampaign.v3+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"campaigns":{"anyOf":[{"type":"array","description":"Campaign array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sp/adGroups":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sp_ad_groups","x-nexscope-slug":"data-amazon-ads-developer-proxy-sp-ad-groups","summary":"Amazon Ads: sp/ad Groups API","description":"Amazon Ads: sp/ad Groups API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: `POST` creation, `PUT` modification."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/vnd.spAdGroup.v3+json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.spAdGroup.v3+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"adGroups":{"anyOf":[{"type":"array","description":"Array of ad groups; actual fields are returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sp/adGroups/list":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sp_ad_groups_list","x-nexscope-slug":"data-amazon-ads-developer-proxy-sp-ad-groups-list","summary":"Amazon Ads: sp/ad Groups/list API","description":"Amazon Ads: sp/ad Groups/list API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method; list query is `POST`."},"body":{"type":"string","description":"The filter and Amazon native request body are placed in the body string; the paging method is subject to the `fetchAll` description of the corresponding interface."},"contentType":{"type":"string","description":"application/vnd.spAdGroup.v3+json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.spAdGroup.v3+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"adGroups":{"anyOf":[{"type":"array","description":"Ad group query Array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sp/keywords":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sp_keywords","x-nexscope-slug":"data-amazon-ads-developer-proxy-sp-keywords","summary":"Amazon Ads: sp/keywords API","description":"Amazon Ads: sp/keywords API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: `POST` creation, `PUT` modification."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/vnd.spKeyword.v3+json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.spKeyword.v3+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"keywords":{"anyOf":[{"type":"array","description":"Keywords array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sp/keywords/list":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sp_keywords_list","x-nexscope-slug":"data-amazon-ads-developer-proxy-sp-keywords-list","summary":"Amazon Ads: sp/keywords/list API","description":"Amazon Ads: sp/keywords/list API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method; list query is `POST`."},"body":{"type":"string","description":"The filter and Amazon native request body are placed in the body string; the paging method is subject to the `fetchAll` description of the corresponding interface."},"contentType":{"type":"string","description":"application/vnd.spKeyword.v3+json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.spKeyword.v3+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"keywords":{"anyOf":[{"type":"array","description":"Keyword query array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sp/negativeKeywords":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sp_negative_keywords","x-nexscope-slug":"data-amazon-ads-developer-proxy-sp-negative-keywords","summary":"Amazon Ads: sp/negative Keywords API","description":"Amazon Ads: sp/negative Keywords API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: `POST` creation, `PUT` modification."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/vnd.spNegativeKeyword.v3+json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.spNegativeKeyword.v3+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"negativeKeywords":{"anyOf":[{"type":"array","description":"Negative keyword array; the actual fields are returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sp/negativeKeywords/list":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sp_negative_keywords_list","x-nexscope-slug":"data-amazon-ads-developer-proxy-sp-negative-keywords-list","summary":"Amazon Ads: sp/negative Keywords/list API","description":"Amazon Ads: sp/negative Keywords/list API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method; list query is `POST`."},"body":{"type":"string","description":"The filter and Amazon native request body are placed in the body string; the paging method is subject to the `fetchAll` description of the corresponding interface."},"contentType":{"type":"string","description":"application/vnd.spNegativeKeyword.v3+json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.spNegativeKeyword.v3+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"negativeKeywords":{"anyOf":[{"type":"array","description":"Negative keyword query array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sp/productAds":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sp_product_ads","x-nexscope-slug":"data-amazon-ads-developer-proxy-sp-product-ads","summary":"Amazon Ads: sp/product Ads API","description":"Amazon Ads: sp/product Ads API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: `POST` creation, `PUT` modification."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/vnd.spProductAd.v3+json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.spProductAd.v3+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"productAds":{"anyOf":[{"type":"array","description":"Array of product ads; actual fields are returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sp/productAds/list":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sp_product_ads_list","x-nexscope-slug":"data-amazon-ads-developer-proxy-sp-product-ads-list","summary":"Amazon Ads: sp/product Ads/list API","description":"Amazon Ads: sp/product Ads/list API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method; list query is `POST`."},"body":{"type":"string","description":"The filter and Amazon native request body are placed in the body string; the paging method is subject to the `fetchAll` description of the corresponding interface."},"contentType":{"type":"string","description":"application/vnd.spProductAd.v3+json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.spProductAd.v3+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"productAds":{"anyOf":[{"type":"array","description":"Product Ads Query Array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sp/targets":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sp_targets","x-nexscope-slug":"data-amazon-ads-developer-proxy-sp-targets","summary":"Amazon Ads: sp/targets API","description":"Amazon Ads: sp/targets API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: `POST` creation, `PUT` modification."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/vnd.spTargetingClause.v3+json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.spTargetingClause.v3+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"targetingClauses":{"anyOf":[{"type":"array","description":"Product targeting array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sp/targets/list":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sp_targets_list","x-nexscope-slug":"data-amazon-ads-developer-proxy-sp-targets-list","summary":"Amazon Ads: sp/targets/list API","description":"Amazon Ads: sp/targets/list API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method; list query is `POST`."},"body":{"type":"string","description":"The filter and Amazon native request body are placed in the body string; the paging method is subject to the `fetchAll` description of the corresponding interface."},"contentType":{"type":"string","description":"application/vnd.spTargetingClause.v3+json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.spTargetingClause.v3+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"targetingClauses":{"anyOf":[{"type":"array","description":"Product targeted query array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sp/negativeTargets":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sp_negative_targets","x-nexscope-slug":"data-amazon-ads-developer-proxy-sp-negative-targets","summary":"Amazon Ads: sp/negative Targets API","description":"Amazon Ads: sp/negative Targets API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: `POST` creation, `PUT` modification."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/vnd.spNegativeTargetingClause.v3+json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.spNegativeTargetingClause.v3+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"negativeTargetingClauses":{"anyOf":[{"type":"array","description":"Array of negative product targeting; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sp/campaignNegativeKeywords":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sp_campaign_negative_keywords","x-nexscope-slug":"data-amazon-ads-developer-proxy-sp-campaign-negative-keywords","summary":"Amazon Ads: sp/campaign Negative Keywords API","description":"Amazon Ads: sp/campaign Negative Keywords API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: `POST` creation, `PUT` modification."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/vnd.spCampaignNegativeKeyword.v3+json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.spCampaignNegativeKeyword.v3+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"negativeKeywords":{"anyOf":[{"type":"array","description":"Array of activity-level negative keywords; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sp/campaignNegativeTargets":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sp_campaign_negative_targets","x-nexscope-slug":"data-amazon-ads-developer-proxy-sp-campaign-negative-targets","summary":"Amazon Ads: sp/campaign Negative Targets API","description":"Amazon Ads: sp/campaign Negative Targets API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: `POST` creation, `PUT` modification."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/vnd.spCampaignNegativeTargetingClause.v3+json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.spCampaignNegativeTargetingClause.v3+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"negativeTargetingClauses":{"anyOf":[{"type":"array","description":"Array of activity-level negative product targeting; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sp/budgetRules":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sp_budget_rules","x-nexscope-slug":"data-amazon-ads-developer-proxy-sp-budget-rules","summary":"Amazon Ads: sp/budget Rules API","description":"Amazon Ads: sp/budget Rules API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: list query `GET`, create `POST`, modify `PUT`."},"body":{"type":"string","description":"Provide payload when creating/modifying; not required for list query. You cannot put an Amazon access token into the payload."},"contentType":{"type":"string","description":"application/json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"budgetRules":{"anyOf":[{"type":"array","description":"Budget rules array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sp/budgetRulesAssociation":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sp_budget_rules_association","x-nexscope-slug":"data-amazon-ads-developer-proxy-sp-budget-rules-association","summary":"Amazon Ads: sp/budget Rules Association API","description":"Amazon Ads: sp/budget Rules Association API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method, fixed to `POST`."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"budgetRulesAssociation":{"anyOf":[{"type":"array","description":"Budget rule association array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sb/campaigns":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sb_campaigns","x-nexscope-slug":"data-amazon-ads-developer-proxy-sb-campaigns","summary":"Amazon Ads: sb/campaigns API","description":"Amazon Ads: sb/campaigns API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: `POST` creation, `PUT` modification."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/vnd.sbcampaignresource.v4+json。"},"accept":{"type":"string","description":"`application/vnd.sbcampaignresource.v4+json`;The old script path is actually forwarded to SB V4."},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.sbcampaignresource.v4+json","accept":"application/vnd.sbcampaignresource.v4+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"campaigns":{"anyOf":[{"type":"array","description":"Sponsored Brands campaign array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sb/adGroups":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sb_ad_groups","x-nexscope-slug":"data-amazon-ads-developer-proxy-sb-ad-groups","summary":"Amazon Ads: sb/ad Groups API","description":"Amazon Ads: sb/ad Groups API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: `POST` creation, `PUT` modification."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/vnd.sbadgroupresource.v4+json。"},"accept":{"type":"string","description":"`application/vnd.sbadgroupresource.v4+json`;The old script path is actually forwarded to SB V4."},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.sbadgroupresource.v4+json","accept":"application/vnd.sbadgroupresource.v4+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"adGroups":{"anyOf":[{"type":"array","description":"Array of Sponsored Brands ad groups; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sb/keywords":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sb_keywords","x-nexscope-slug":"data-amazon-ads-developer-proxy-sb-keywords","summary":"Amazon Ads: sb/keywords API","description":"Amazon Ads: sb/keywords API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method: `GET/POST/PUT`; GET is used for keyword list, POST/PUT is used for creation/modification."},"body":{"type":"string","description":"Payload must be provided when creating or modifying POST/PUT; GET list passes paging and filtering parameters through queryString."},"contentType":{"type":"string","description":"POST/PUT uses `application/json`; GET list does not send Content-Type."},"accept":{"type":"string","description":"V4 create/update uses `application/vnd.sbkeywordresponse.v3+json`; V4 GET list uses `application/vnd.sbkeyword.v3+json`; V3 compatible scripts are usually not passed."},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/json","accept":"application/vnd.sbkeywordresponse.v3+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"keywords":{"anyOf":[{"type":"array","description":"Sponsored Brands keyword array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sb/targets":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sb_targets","x-nexscope-slug":"data-amazon-ads-developer-proxy-sb-targets","summary":"Amazon Ads: sb/targets API","description":"Amazon Ads: sb/targets API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: `POST` creation, `PUT` modification."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"targetingClauses":{"anyOf":[{"type":"array","description":"Sponsored Brands product targeting array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sb/targets/list":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sb_targets_list","x-nexscope-slug":"data-amazon-ads-developer-proxy-sb-targets-list","summary":"Amazon Ads: sb/targets/list API","description":"Amazon Ads: sb/targets/list API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method; list query is `POST`."},"body":{"type":"string","description":"The filter and Amazon native request body are placed in the body string; the paging method is subject to the `fetchAll` description of the corresponding interface."},"contentType":{"type":"string","description":"application/json。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"targetingClauses":{"anyOf":[{"type":"array","description":"Array of Sponsored Brands product targeted queries; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sb/v4/campaigns":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sb_v4_campaigns","x-nexscope-slug":"data-amazon-ads-developer-proxy-sb-v4-campaigns","summary":"Amazon Ads: sb/v4/campaigns API","description":"Amazon Ads: sb/v4/campaigns API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: `POST` creation, `PUT` modification."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/vnd.sbcampaignresource.v4+json。"},"accept":{"type":"string","description":"`application/vnd.sbcampaignresource.v4+json`。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.sbcampaignresource.v4+json","accept":"application/vnd.sbcampaignresource.v4+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"campaigns":{"anyOf":[{"type":"array","description":"Sponsored Brands V4 campaign array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sb/v4/campaigns/list":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sb_v4_campaigns_list","x-nexscope-slug":"data-amazon-ads-developer-proxy-sb-v4-campaigns-list","summary":"Amazon Ads: sb/v4/campaigns/list API","description":"Amazon Ads: sb/v4/campaigns/list API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method; list query is `POST`."},"body":{"type":"string","description":"The filter and Amazon native request body are placed in the body string; the paging method is subject to the `fetchAll` description of the corresponding interface."},"contentType":{"type":"string","description":"application/vnd.sbcampaignresource.v4+json。"},"accept":{"type":"string","description":"`application/vnd.sbcampaignresource.v4+json`。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.sbcampaignresource.v4+json","accept":"application/vnd.sbcampaignresource.v4+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"campaigns":{"anyOf":[{"type":"array","description":"Sponsored Brands V4 campaign query array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sb/v4/adGroups":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sb_v4_ad_groups","x-nexscope-slug":"data-amazon-ads-developer-proxy-sb-v4-ad-groups","summary":"Amazon Ads: sb/v4/ad Groups API","description":"Amazon Ads: sb/v4/ad Groups API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: `POST` creation, `PUT` modification."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/vnd.sbadgroupresource.v4+json。"},"accept":{"type":"string","description":"`application/vnd.sbadgroupresource.v4+json`。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.sbadgroupresource.v4+json","accept":"application/vnd.sbadgroupresource.v4+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"adGroups":{"anyOf":[{"type":"array","description":"Array of Sponsored Brands V4 ad groups; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sb/v4/adGroups/list":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sb_v4_ad_groups_list","x-nexscope-slug":"data-amazon-ads-developer-proxy-sb-v4-ad-groups-list","summary":"Amazon Ads: sb/v4/ad Groups/list API","description":"Amazon Ads: sb/v4/ad Groups/list API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method; list query is `POST`."},"body":{"type":"string","description":"The filter and Amazon native request body are placed in the body string; the paging method is subject to the `fetchAll` description of the corresponding interface."},"contentType":{"type":"string","description":"application/vnd.sbadgroupresource.v4+json。"},"accept":{"type":"string","description":"`application/vnd.sbadgroupresource.v4+json`。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.sbadgroupresource.v4+json","accept":"application/vnd.sbadgroupresource.v4+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"adGroups":{"anyOf":[{"type":"array","description":"Sponsored Brands V4 ad group query array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sb/v4/ads":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sb_v4_ads","x-nexscope-slug":"data-amazon-ads-developer-proxy-sb-v4-ads","summary":"Amazon Ads: sb/v4/ads API","description":"Amazon Ads: sb/v4/ads API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method, fixed to `PUT`."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/vnd.sbadresource.v4+json。"},"accept":{"type":"string","description":"`application/vnd.sbadresource.v4+json`。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.sbadresource.v4+json","accept":"application/vnd.sbadresource.v4+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"ads":{"anyOf":[{"type":"array","description":"Array of Sponsored Brands V4 ads; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sb/v4/ads/list":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sb_v4_ads_list","x-nexscope-slug":"data-amazon-ads-developer-proxy-sb-v4-ads-list","summary":"Amazon Ads: sb/v4/ads/list API","description":"Amazon Ads: sb/v4/ads/list API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method; list query is `POST`."},"body":{"type":"string","description":"The filter and Amazon native request body are placed in the body string; the paging method is subject to the `fetchAll` description of the corresponding interface."},"contentType":{"type":"string","description":"application/vnd.sbadresource.v4+json。"},"accept":{"type":"string","description":"`application/vnd.sbadresource.v4+json`。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.sbadresource.v4+json","accept":"application/vnd.sbadresource.v4+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"ads":{"anyOf":[{"type":"array","description":"Sponsored Brands V4 ad query array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sb/v4/ads/by-ad_type":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sb_v4_ads_ad_type","x-nexscope-slug":"data-amazon-ads-developer-proxy-sb-v4-ads-ad-type","summary":"Amazon Ads: sb/v4/ads/{ad type} API","description":"Amazon Ads: sb/v4/ads/{ad type} API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method; list query is `POST`."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/vnd.sbadresource.v4+json。"},"accept":{"type":"string","description":"`application/vnd.sbadresource.v4+json`。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."},"ad_type":{"type":"string","description":"Resource identifier for this operation."}},"required":["connectionId","method","body","ad_type"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.sbadresource.v4+json","accept":"application/vnd.sbadresource.v4+json","connectionId":123,"ad_type":"brandVideo"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"ads":{"anyOf":[{"type":"array","description":"Sponsored Brands V4 Array of ad types specified; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sb/ads/creatives/list":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sb_ads_creatives_list","x-nexscope-slug":"data-amazon-ads-developer-proxy-sb-ads-creatives-list","summary":"Amazon Ads: sb/ads/creatives/list API","description":"Amazon Ads: sb/ads/creatives/list API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method; list query is `POST`."},"body":{"type":"string","description":"The filter and Amazon native request body are placed in the body string; the paging method is subject to the `fetchAll` description of the corresponding interface."},"contentType":{"type":"string","description":"application/vnd.sbAdCreativeResource.v4+json。"},"accept":{"type":"string","description":"`application/vnd.sbAdCreativeResource.v4+json`。"},"adId":{"type":["string","number"],"description":"To query the Ad ID of Creative Version; not the full account Creative list."},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","adId"],"additionalProperties":true},"example":{"method":"POST","body":"{\"adId\":\"998877\"}","contentType":"application/vnd.sbAdCreativeResource.v4+json","accept":"application/vnd.sbAdCreativeResource.v4+json","connectionId":123,"adId":"123456789012"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"creatives":{"anyOf":[{"type":"array","description":"Sponsored Brands Creative Version query array; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sb/ads/creatives/by-creative_type":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sb_ads_creatives_creative_type","x-nexscope-slug":"data-amazon-ads-developer-proxy-sb-ads-creatives-creative-type","summary":"Amazon Ads: sb/ads/creatives/{creative type} API","description":"Amazon Ads: sb/ads/creatives/{creative type} API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method: `POST`; this entry only creates Creative Version and does not provide updates."},"body":{"type":"string","description":"The payload must be provided; the skill will serialize it and forward it to the upstream, and the Amazon access token cannot be put into the payload."},"contentType":{"type":"string","description":"application/vnd.sbAdCreativeResource.v4+json。"},"accept":{"type":"string","description":"`application/vnd.sbAdCreativeResource.v4+json`。"},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."},"creative_type":{"type":"string","description":"Resource identifier for this operation."}},"required":["connectionId","method","body","creative_type"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/vnd.sbAdCreativeResource.v4+json","accept":"application/vnd.sbAdCreativeResource.v4+json","connectionId":123,"creative_type":"brandVideo"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"creatives":{"anyOf":[{"type":"array","description":"Sponsored Brands Creative Version creates the array; the actual fields are returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sb/budgetRules":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sb_budget_rules","x-nexscope-slug":"data-amazon-ads-developer-proxy-sb-budget-rules","summary":"Amazon Ads: sb/budget Rules API","description":"Amazon Ads: sb/budget Rules API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: `GET` for list, `POST/PUT` for create/modify."},"body":{"type":"string","description":"Create/modify must provide payload; list uses queryString."},"contentType":{"type":"string","description":"Create/modify using `application/json`; GET list does not send Content-Type."},"accept":{"type":"string","description":"`application/json`。"},"pageSize":{"type":"integer","description":"SB V4 Budget Rule GET list number per page, range 1–100; list pagination also uses `nextToken`.","default":100},"queryString":{"type":"string","description":"Pass upstream query parameters when needed."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/json","accept":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"budgetRules":{"anyOf":[{"type":"array","description":"Array of Sponsored Brands Budget Rules; actual fields returned by Amazon.","example":null},{"type":"null"}]},"budgetRulesForAdvertiserResponse":{"anyOf":[{"type":"array","description":"Raw list fields that may be returned by Amazon GET list; skill normalizes them to `budgetRules`.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sd/campaigns":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sd_campaigns","x-nexscope-slug":"data-amazon-ads-developer-proxy-sd-campaigns","summary":"Amazon Ads: sd/campaigns API","description":"Amazon Ads: sd/campaigns API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: list query `GET`, create `POST`, modify `PUT`."},"body":{"type":"string","description":"Optional filters will be serialized to queryString when querying; payload must be provided when creating/modifying."},"contentType":{"type":"string","description":"application/json or the Content-Type corresponding to the Amazon resource version."},"queryString":{"type":"string","description":"SD query filters and paging parameters."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"GET","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"campaigns":{"anyOf":[{"type":"array","description":"Array of Sponsored Display campaigns; actual fields are returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sd/campaigns/extended":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sd_campaigns_extended","x-nexscope-slug":"data-amazon-ads-developer-proxy-sd-campaigns-extended","summary":"Amazon Ads: sd/campaigns/extended API","description":"Amazon Ads: sd/campaigns/extended API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method; list query is `GET`."},"body":{"type":"string","description":"Optional filters are serialized to queryString; `asinFilter`/`skuFilter` (product ads) are accurately filtered locally by the skill."},"contentType":{"type":"string","description":"application/json or the Content-Type corresponding to the Amazon resource version."},"queryString":{"type":"string","description":"SD query filters and paging parameters."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"GET","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"campaigns":{"anyOf":[{"type":"array","description":"Sponsored Display Campaign extension field query array; actual fields are returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sd/adGroups":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sd_ad_groups","x-nexscope-slug":"data-amazon-ads-developer-proxy-sd-ad-groups","summary":"Amazon Ads: sd/ad Groups API","description":"Amazon Ads: sd/ad Groups API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: list query `GET`, create `POST`, modify `PUT`."},"body":{"type":"string","description":"Optional filters will be serialized to queryString when querying; payload must be provided when creating/modifying."},"contentType":{"type":"string","description":"application/json or the Content-Type corresponding to the Amazon resource version."},"queryString":{"type":"string","description":"SD query filters and paging parameters."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"GET","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"adGroups":{"anyOf":[{"type":"array","description":"Array of Sponsored Display ad groups; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sd/adGroups/extended":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sd_ad_groups_extended","x-nexscope-slug":"data-amazon-ads-developer-proxy-sd-ad-groups-extended","summary":"Amazon Ads: sd/ad Groups/extended API","description":"Amazon Ads: sd/ad Groups/extended API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method; list query is `GET`."},"body":{"type":"string","description":"Optional filters are serialized to queryString; `asinFilter`/`skuFilter` (product ads) are accurately filtered locally by the skill."},"contentType":{"type":"string","description":"application/json or the Content-Type corresponding to the Amazon resource version."},"queryString":{"type":"string","description":"SD query filters and paging parameters."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"GET","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"adGroups":{"anyOf":[{"type":"array","description":"Sponsored Display Ad group extension field query array; actual fields are returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sd/productAds":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sd_product_ads","x-nexscope-slug":"data-amazon-ads-developer-proxy-sd-product-ads","summary":"Amazon Ads: sd/product Ads API","description":"Amazon Ads: sd/product Ads API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: list query `GET`, create `POST`, modify `PUT`."},"body":{"type":"string","description":"Optional filters will be serialized to queryString when querying; payload must be provided when creating/modifying."},"contentType":{"type":"string","description":"application/json or the Content-Type corresponding to the Amazon resource version."},"queryString":{"type":"string","description":"SD query filters and paging parameters."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"GET","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"productAds":{"anyOf":[{"type":"array","description":"Array of Sponsored Display product ads; actual fields are returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sd/productAds/extended":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sd_product_ads_extended","x-nexscope-slug":"data-amazon-ads-developer-proxy-sd-product-ads-extended","summary":"Amazon Ads: sd/product Ads/extended API","description":"Amazon Ads: sd/product Ads/extended API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method; list query is `GET`."},"body":{"type":"string","description":"Optional filters are serialized to queryString; `asinFilter`/`skuFilter` (product ads) are accurately filtered locally by the skill."},"contentType":{"type":"string","description":"application/json or the Content-Type corresponding to the Amazon resource version."},"queryString":{"type":"string","description":"SD query filters and paging parameters."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"GET","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"productAds":{"anyOf":[{"type":"array","description":"Sponsored Display Product ad extension field query array; actual fields are returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sd/targets":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sd_targets","x-nexscope-slug":"data-amazon-ads-developer-proxy-sd-targets","summary":"Amazon Ads: sd/targets API","description":"Amazon Ads: sd/targets API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: list query `GET`, create `POST`, modify `PUT`."},"body":{"type":"string","description":"Optional filters will be serialized to queryString when querying; payload must be provided when creating/modifying."},"contentType":{"type":"string","description":"application/json or the Content-Type corresponding to the Amazon resource version."},"queryString":{"type":"string","description":"SD query filters and paging parameters."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"GET","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"targetingClauses":{"anyOf":[{"type":"array","description":"Sponsored Display array of targeting clauses; the actual fields are returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sd/targets/extended":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sd_targets_extended","x-nexscope-slug":"data-amazon-ads-developer-proxy-sd-targets-extended","summary":"Amazon Ads: sd/targets/extended API","description":"Amazon Ads: sd/targets/extended API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method; list query is `GET`."},"body":{"type":"string","description":"Optional filters are serialized to queryString; `asinFilter`/`skuFilter` (product ads) are accurately filtered locally by the skill."},"contentType":{"type":"string","description":"application/json or the Content-Type corresponding to the Amazon resource version."},"queryString":{"type":"string","description":"SD query filters and paging parameters."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"GET","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"targetingClauses":{"anyOf":[{"type":"array","description":"Sponsored Display Directed clause extended field query array; the actual fields are returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sd/negativeTargets":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sd_negative_targets","x-nexscope-slug":"data-amazon-ads-developer-proxy-sd-negative-targets","summary":"Amazon Ads: sd/negative Targets API","description":"Amazon Ads: sd/negative Targets API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: list query `GET`, create `POST`, modify `PUT`."},"body":{"type":"string","description":"Optional filters will be serialized to queryString when querying; payload must be provided when creating/modifying."},"contentType":{"type":"string","description":"application/json or the Content-Type corresponding to the Amazon resource version."},"queryString":{"type":"string","description":"SD query filters and paging parameters."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"GET","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"negativeTargetingClauses":{"anyOf":[{"type":"array","description":"Sponsored Display array of negative targeting clauses; the actual fields are returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sd/negativeTargets/extended":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sd_negative_targets_extended","x-nexscope-slug":"data-amazon-ads-developer-proxy-sd-negative-targets-extended","summary":"Amazon Ads: sd/negative Targets/extended API","description":"Amazon Ads: sd/negative Targets/extended API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP method; list query is `GET`."},"body":{"type":"string","description":"Optional filters are serialized to queryString; `asinFilter`/`skuFilter` (product ads) are accurately filtered locally by the skill."},"contentType":{"type":"string","description":"application/json or the Content-Type corresponding to the Amazon resource version."},"queryString":{"type":"string","description":"SD query filters and paging parameters."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"GET","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"negativeTargetingClauses":{"anyOf":[{"type":"array","description":"Sponsored Display Negative targeting clause extended field query array; the actual fields are returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sd/creatives":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sd_creatives","x-nexscope-slug":"data-amazon-ads-developer-proxy-sd-creatives","summary":"Amazon Ads: sd/creatives API","description":"Amazon Ads: sd/creatives API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: list query `GET`, create `POST`, modify `PUT`."},"body":{"type":"string","description":"Optional filters will be serialized to queryString when querying; payload must be provided when creating/modifying."},"contentType":{"type":"string","description":"application/json or the Content-Type corresponding to the Amazon resource version."},"queryString":{"type":"string","description":"SD query filters and paging parameters."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"GET","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"creatives":{"anyOf":[{"type":"array","description":"Array of Sponsored Display creatives; actual fields are returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/sd/budgetRules":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_sd_budget_rules","x-nexscope-slug":"data-amazon-ads-developer-proxy-sd-budget-rules","summary":"Amazon Ads: sd/budget Rules API","description":"Amazon Ads: sd/budget Rules API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"fetchAll":{"type":"boolean","description":"Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`.","default":true},"maxResults":{"type":"integer","description":"Single page 1–100; SD corresponds to count.","default":100},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"includeExtendedDataFields":{"type":"boolean","description":"Some entities return extended fields; SD is switched through the /extended path."},"locale":{"type":"string","description":"Localization parameters (supported by some keyword scripts)."},"method":{"type":"string","description":"Upstream HTTP methods: list query `GET`, create `POST`, modify `PUT`."},"body":{"type":"string","description":"Provide payload when creating/modifying; not required for list query. You cannot put an Amazon access token into the payload."},"contentType":{"type":"string","description":"application/json or the Content-Type corresponding to the Amazon resource version."},"queryString":{"type":"string","description":"SD query filters and paging parameters."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the skill completed the call successfully.","example":null},{"type":"null"}]},"apiVersion":{"anyOf":[{"type":"string","description":"`V3` or `V4` (if provided by the script).","example":null},{"type":"null"}]},"amazonResourceVersion":{"anyOf":[{"type":"string","description":"The actual Amazon resource version (if provided by the script).","example":null},{"type":"null"}]},"budgetRules":{"anyOf":[{"type":"array","description":"Sponsored Display array of budget rules; actual fields returned by Amazon.","example":null},{"type":"null"}]},"total":{"anyOf":[{"type":"integer","description":"The number of aggregated entries (if provided by the script).","example":null},{"type":"null"}]},"pagesFetched":{"anyOf":[{"type":"integer","description":"Number of pages obtained.","example":null},{"type":"null"}]},"truncated":{"anyOf":[{"type":"boolean","description":"Whether it was truncated due to paging limit.","example":null},{"type":"null"}]},"name":{"anyOf":[{"type":"string","description":"Name (returned if supported by the entity).","example":null},{"type":"null"}]},"state":{"anyOf":[{"type":"string","description":"`ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase).","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/reporting/reports":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_reporting_reports","x-nexscope-slug":"data-amazon-ads-developer-proxy-reporting-reports","summary":"Amazon Ads: reporting/reports API","description":"Amazon Ads: reporting/reports API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"reportTypeId":{"type":"string","description":"Check the corresponding report-types file."},"adProduct":{"type":"string","description":"Contrast report-type frontmatter, such as `SPONSORED_PRODUCTS`, `SPONSORED_BRANDS`, `SPONSORED_DISPLAY`."},"groupBy":{"type":"array","description":"Compare report-type frontmatter; no guesswork required.","items":{"type":"object"}},"columns":{"type":"array","description":"Check against a subset of allowed columns of the corresponding Base metrics table.","items":{"type":"object"}},"startDate":{"type":"string","description":"`YYYY-MM-DD`, including the current day."},"endDate":{"type":"string","description":"`YYYY-MM-DD`, including the current day."},"name":{"type":"string","description":"Report display name."},"timeUnit":{"type":"string","description":"`DAILY` or `SUMMARY`.","default":"SUMMARY"},"format":{"type":"string","description":"Report file format.","default":"GZIP_JSON"},"filters":{"type":"array","description":"Field and value enumerations are based on the corresponding report-type file.","items":{"type":"object"}},"pollInterval":{"type":"integer","description":"Polling interval in seconds.","default":30},"maxAttempts":{"type":"integer","description":"Maximum number of polls, default waiting window of approximately 10 minutes.","default":20},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"serveExtractedFileHttp":{"type":"boolean","description":"Whether to start the native temporary HTTP service.","default":true},"serveHost":{"type":"string","description":"Native service binding address."},"servePort":{"type":"integer","description":"0 indicates the system allocated port.","default":0},"serveSeconds":{"type":"integer","description":"The number of seconds the local link remains alive.","default":300},"includeAmazonSourceUrl":{"type":"boolean","description":"Whether to return the Amazon presigned source URL.","default":false},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId"],"additionalProperties":true},"example":{"method":"POST","body":"{\"name\":\"Campaign report\",\"startDate\":\"2026-07-01\",\"endDate\":\"2026-07-07\",\"configuration\":{\"reportTypeId\":\"spCampaigns\",\"adProduct\":\"SPONSORED_PRODUCTS\",\"groupBy\":[\"campaign\"],\"columns\":[\"campaignId\",\"impressions\",\"clicks\"],\"timeUnit\":\"DAILY\",\"format\":\"GZIP_JSON\"}}","contentType":"application/vnd.createasyncreportrequest.v3+json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether downloaded and decompressed successfully.","example":null},{"type":"null"}]},"reportId":{"anyOf":[{"type":"string","description":"Amazon reporting ID.","example":null},{"type":"null"}]},"status":{"anyOf":[{"type":"string","description":"`PENDING`, `PROCESSING`, `COMPLETED` or `FAILED`.","example":null},{"type":"null"}]},"reportTypeId":{"anyOf":[{"type":"string","description":"The type of report requested.","example":null},{"type":"null"}]},"pollAttempts":{"anyOf":[{"type":"integer","description":"Number of times polled.","example":null},{"type":"null"}]},"elapsedSeconds":{"anyOf":[{"type":"number","description":"The number of seconds elapsed.","example":null},{"type":"null"}]},"downloadPath":{"anyOf":[{"type":"string","description":"The downloaded or decompressed local file path.","example":null},{"type":"null"}]},"extractedFileHttpUrl":{"anyOf":[{"type":"string","description":"Native temporary file URL (if enabled).","example":null},{"type":"null"}]},"serveExpiresAt":{"anyOf":[{"type":"string","description":"Native URL expiration time (if returned).","example":null},{"type":"null"}]},"failureReason":{"anyOf":[{"type":"string","description":"Reason for upstream failure when `FAILED`.","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]},"resumeHint":{"type":"object","properties":{"mode":{"anyOf":[{"type":"string","description":"`poll-only`。","example":null},{"type":"null"}]},"params":{"anyOf":[{"type":"object","description":"Reuse the same reportId and increase maxAttempts to continue polling.","example":null},{"type":"null"}]}}}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/reporting/reports/by-reportId":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_reporting_reports_report_id","x-nexscope-slug":"data-amazon-ads-developer-proxy-reporting-reports-report-id","summary":"Amazon Ads: reporting/reports/{report Id} API","description":"Amazon Ads: reporting/reports/{report Id} API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"reportId":{"type":"string","description":"Report ID created; creation skipped after passed in."},"name":{"type":"string","description":"Report display name."},"timeUnit":{"type":"string","description":"`DAILY` or `SUMMARY`.","default":"SUMMARY"},"format":{"type":"string","description":"Report file format.","default":"GZIP_JSON"},"filters":{"type":"array","description":"Field and value enumerations are based on the corresponding report-type file.","items":{"type":"object"}},"pollInterval":{"type":"integer","description":"Polling interval in seconds.","default":30},"maxAttempts":{"type":"integer","description":"Maximum number of polls, default waiting window of approximately 10 minutes.","default":20},"skipDepCheck":{"type":"boolean","description":"Skip dependency checking.","default":false},"serveExtractedFileHttp":{"type":"boolean","description":"Whether to start the native temporary HTTP service.","default":true},"serveHost":{"type":"string","description":"Native service binding address."},"servePort":{"type":"integer","description":"0 indicates the system allocated port.","default":0},"serveSeconds":{"type":"integer","description":"The number of seconds the local link remains alive.","default":300},"includeAmazonSourceUrl":{"type":"boolean","description":"Whether to return the Amazon presigned source URL.","default":false},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","reportId"],"additionalProperties":true},"example":{"method":"GET","body":"{\"reportTypeId\":\"spCampaigns\"}","contentType":"application/vnd.createasyncreportrequest.v3+json","connectionId":123,"reportId":"REPLACE_WITH_REPORT_ID"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether downloaded and decompressed successfully.","example":null},{"type":"null"}]},"reportId":{"anyOf":[{"type":"string","description":"Amazon reporting ID.","example":null},{"type":"null"}]},"status":{"anyOf":[{"type":"string","description":"`PENDING`, `PROCESSING`, `COMPLETED` or `FAILED`.","example":null},{"type":"null"}]},"reportTypeId":{"anyOf":[{"type":"string","description":"The type of report requested.","example":null},{"type":"null"}]},"pollAttempts":{"anyOf":[{"type":"integer","description":"Number of times polled.","example":null},{"type":"null"}]},"elapsedSeconds":{"anyOf":[{"type":"number","description":"The number of seconds elapsed.","example":null},{"type":"null"}]},"downloadPath":{"anyOf":[{"type":"string","description":"The downloaded or decompressed local file path.","example":null},{"type":"null"}]},"extractedFileHttpUrl":{"anyOf":[{"type":"string","description":"Native temporary file URL (if enabled).","example":null},{"type":"null"}]},"serveExpiresAt":{"anyOf":[{"type":"string","description":"Native URL expiration time (if returned).","example":null},{"type":"null"}]},"failureReason":{"anyOf":[{"type":"string","description":"Reason for upstream failure when `FAILED`.","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]},"resumeHint":{"type":"object","properties":{"mode":{"anyOf":[{"type":"string","description":"`poll-only`。","example":null},{"type":"null"}]},"params":{"anyOf":[{"type":"object","description":"Reuse the same reportId and increase maxAttempts to continue polling.","example":null},{"type":"null"}]}}}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/adsApi/v1/query/advertiserAccounts":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_ads_api_v1_query_advertiser_accounts","x-nexscope-slug":"data-amazon-ads-developer-proxy-ads-api-v1-query-advertiser-accounts","summary":"Amazon Ads Advertiser Accounts","description":"Amazon Ads Advertiser Accounts. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"method":{"type":"string","const":"POST","description":"The upstream account query uses POST."},"body":{"type":"string","description":"JSON string for the Amazon Ads query. Use {} for accessible accounts, or include advertiserAccountIdFilter, isGlobalAccountFilter, maxResults (10-100), and nextToken."},"contentType":{"type":"string","description":"Use application/json."}},"required":["connectionId","method"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","description":"Amazon Ads QueryAdvertiserAccount 200 response; the Nexscope route returns the provider account payload.","properties":{"advertiserAccounts":{"anyOf":[{"type":"array","description":"Advertiser accounts on this page (0-100). An empty array means no matching accounts.","minItems":0,"maxItems":100,"items":{"type":"object","properties":{"advertiserAccountId":{"type":"string","description":"Unique Amazon Ads advertiser account ID."},"alternateIds":{"type":"array","minItems":0,"maxItems":30,"description":"Marketplace identifiers associated with this account.","items":{"type":"object","properties":{"countryCode":{"type":"string","description":"Marketplace country code."},"dspAdvertiserId":{"type":"string","description":"Regional DSP advertiser ID."},"entityId":{"type":"string","description":"Marketplace entity ID."},"profileId":{"type":"string","description":"Marketplace profile ID."},"region":{"type":"string","enum":["EU","FE","NA"],"description":"Amazon Ads region."}}}},"businessDetails":{"type":"array","minItems":1,"maxItems":1,"description":"Business details for the advertiser account.","items":{"type":"object","properties":{"address":{"type":"object","description":"Business address, when returned; contains sensitive contact details."},"addressToken":{"type":"string","description":"Linked business address token; sensitive."},"businessRegistrationNumber":{"type":"string","description":"Business registration number; sensitive."},"website":{"type":"string","description":"Business website."}}}},"currencyCode":{"type":"string","description":"Account currency code."},"displayName":{"type":"string","description":"Advertiser account display name."},"industryVertical":{"type":"string","description":"Industry vertical."},"isGlobalAccount":{"type":"boolean","description":"Whether this is a global advertiser account."},"isTestAccount":{"type":"boolean","description":"Whether this is a test account."},"managerAccountId":{"type":"string","description":"Linked manager account ID."},"sellingAccountLinkRequests":{"type":"array","minItems":0,"maxItems":1,"description":"Selling account link requests.","items":{"type":"object"}},"status":{"type":"object","description":"Current advertiser account status.","properties":{"statusCode":{"type":"string","enum":["APPROVED","ARCHIVED","REGISTRATION_IN_PROGRESS","REJECTED"],"description":"Current account state."},"statusMessage":{"type":"string","description":"Human-readable status message."}},"required":["statusCode","statusMessage"]},"timeZoneIana":{"type":"string","description":"Account time zone in IANA format."}},"required":["advertiserAccountId","businessDetails","status"]}},{"type":"null"}]},"nextToken":{"anyOf":[{"type":"string","description":"Continuation token for the next page, when returned."},{"type":"null"}]}},"required":[]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"advertiserAccounts":[{"advertiserAccountId":"amzn1.ads-account.example","alternateIds":[{"countryCode":"US","profileId":"1234567890","region":"NA"}],"businessDetails":[{}],"displayName":"Example Advertiser","isGlobalAccount":false,"status":{"statusCode":"APPROVED","statusMessage":"Approved"}}],"nextToken":"example-next-token"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/adsApi/v1/create/reports":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_ads_api_v1_create_reports","x-nexscope-slug":"data-amazon-ads-developer-proxy-ads-api-v1-create-reports","summary":"Amazon Ads: ads Api/v1/create/reports API","description":"Amazon Ads: ads Api/v1/create/reports API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"method":{"type":"string","description":"The three stages of Ads v1 are all `POST`."},"body":{"type":"string","description":"JSON string; account query can be `{}`, report creation/polling see dedicated reference respectively."},"contentType":{"type":"string","description":"Typically `application/json`."},"pollInterval":{"type":"integer","description":"5–300 seconds; official recommendation is to poll every minute.","default":60},"maxAttempts":{"type":"integer","description":"1–120, default waiting window of approximately 10 minutes.","default":10},"reportId":{"type":"string","description":"After passing in, account mapping and creation will be skipped, and existing reports will only be polled."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the entry script completes report processing.","example":null},{"type":"null"}]},"status":{"anyOf":[{"type":"string","description":"`PENDING`, `PROCESSING`, `COMPLETED`, `FAILED` or `STILL_PROCESSING`.","example":null},{"type":"null"}]},"reportId":{"anyOf":[{"type":"string","description":"Report ID.","example":null},{"type":"null"}]},"reportKind":{"anyOf":[{"type":"string","description":"`audience` or `search-impression-share`.","example":null},{"type":"null"}]},"profileId":{"anyOf":[{"type":"number","description":"Ads profile used.","example":null},{"type":"null"}]},"advertiserAccountId":{"anyOf":[{"type":"string","description":"The Ads v1 account ID mapped to.","example":null},{"type":"null"}]},"fields":{"anyOf":[{"type":"array","description":"The actual fixed field combination (as returned).","example":null},{"type":"null"}]},"totalRows":{"anyOf":[{"type":"integer","description":"The total number of rows after merging; 0 is a legally empty report.","example":null},{"type":"null"}]},"dataFiles[]":{"type":"array","description":"Local CSV slice file and row number.","example":null},"preview[]":{"type":"array","description":"Results preview.","example":null},"resumeHint":{"anyOf":[{"type":"object","description":"Continue parameters during STILL_PROCESSING.","example":null},{"type":"null"}]},"_cacheable":{"anyOf":[{"type":"boolean","description":"Successful results are cached for 24 hours; failed/incomplete is false.","example":null},{"type":"null"}]},"part":{"anyOf":[{"type":"integer","description":"Fragment serial number.","example":null},{"type":"null"}]},"path":{"anyOf":[{"type":"string","description":"Local CSV file path.","example":null},{"type":"null"}]},"rowCount":{"anyOf":[{"type":"integer","description":"The number of rows in this shard.","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/adsApi/v1/retrieve/reports":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_ads_api_v1_retrieve_reports","x-nexscope-slug":"data-amazon-ads-developer-proxy-ads-api-v1-retrieve-reports","summary":"Amazon Ads: ads Api/v1/retrieve/reports API","description":"Amazon Ads: ads Api/v1/retrieve/reports API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"method":{"type":"string","description":"The three stages of Ads v1 are all `POST`."},"body":{"type":"string","description":"JSON string; account query can be `{}`, report creation/polling see dedicated reference respectively."},"contentType":{"type":"string","description":"Typically `application/json`."},"pollInterval":{"type":"integer","description":"5–300 seconds; official recommendation is to poll every minute.","default":60},"maxAttempts":{"type":"integer","description":"1–120, default waiting window of approximately 10 minutes.","default":10},"reportId":{"type":"string","description":"After passing in, account mapping and creation will be skipped, and existing reports will only be polled."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the entry script completes report processing.","example":null},{"type":"null"}]},"status":{"anyOf":[{"type":"string","description":"`PENDING`, `PROCESSING`, `COMPLETED`, `FAILED` or `STILL_PROCESSING`.","example":null},{"type":"null"}]},"reportId":{"anyOf":[{"type":"string","description":"Report ID.","example":null},{"type":"null"}]},"reportKind":{"anyOf":[{"type":"string","description":"`audience` or `search-impression-share`.","example":null},{"type":"null"}]},"profileId":{"anyOf":[{"type":"number","description":"Ads profile used.","example":null},{"type":"null"}]},"advertiserAccountId":{"anyOf":[{"type":"string","description":"The Ads v1 account ID mapped to.","example":null},{"type":"null"}]},"fields":{"anyOf":[{"type":"array","description":"The actual fixed field combination (as returned).","example":null},{"type":"null"}]},"totalRows":{"anyOf":[{"type":"integer","description":"The total number of rows after merging; 0 is a legally empty report.","example":null},{"type":"null"}]},"dataFiles[]":{"type":"array","description":"Local CSV slice file and row number.","example":null},"preview[]":{"type":"array","description":"Results preview.","example":null},"resumeHint":{"anyOf":[{"type":"object","description":"Continue parameters during STILL_PROCESSING.","example":null},{"type":"null"}]},"_cacheable":{"anyOf":[{"type":"boolean","description":"Successful results are cached for 24 hours; failed/incomplete is false.","example":null},{"type":"null"}]},"part":{"anyOf":[{"type":"integer","description":"Fragment serial number.","example":null},{"type":"null"}]},"path":{"anyOf":[{"type":"string","description":"Local CSV file path.","example":null},{"type":"null"}]},"rowCount":{"anyOf":[{"type":"integer","description":"The number of rows in this shard.","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazonAds/developerProxy":{"post":{"operationId":"nexscope_data_amazon_ads_developer_proxy_amazon_ads_developer_proxy","x-nexscope-slug":"data-amazon-ads-developer-proxy-amazon-ads-developer-proxy","summary":"Amazon Ads: amazon Ads/developer Proxy API","description":"Amazon Ads: amazon Ads/developer Proxy API. Uses your Nexscope Amazon Ads connection. Credentials remain on the server. Mutations require preview and confirmation.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connectionId":{"type":"integer","description":"An Amazon Ads connection owned by the authenticated Nexscope user."},"method":{"type":"string","description":"The three stages of Ads v1 are all `POST`."},"body":{"type":"string","description":"JSON string; account query can be `{}`, report creation/polling see dedicated reference respectively."},"contentType":{"type":"string","description":"Typically `application/json`."},"pollInterval":{"type":"integer","description":"5–300 seconds; official recommendation is to poll every minute.","default":60},"maxAttempts":{"type":"integer","description":"1–120, default waiting window of approximately 10 minutes.","default":10},"reportId":{"type":"string","description":"After passing in, account mapping and creation will be skipped, and existing reports will only be polled."},"confirmationToken":{"type":"string","description":"For mutations, first preview without a token, then confirm using the returned single-use token."}},"required":["connectionId","method","body"],"additionalProperties":true},"example":{"method":"POST","body":"{}","contentType":"application/json","connectionId":123}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"success":{"anyOf":[{"type":"boolean","description":"Whether the entry script completes report processing.","example":null},{"type":"null"}]},"status":{"anyOf":[{"type":"string","description":"`PENDING`, `PROCESSING`, `COMPLETED`, `FAILED` or `STILL_PROCESSING`.","example":null},{"type":"null"}]},"reportId":{"anyOf":[{"type":"string","description":"Report ID.","example":null},{"type":"null"}]},"reportKind":{"anyOf":[{"type":"string","description":"`audience` or `search-impression-share`.","example":null},{"type":"null"}]},"profileId":{"anyOf":[{"type":"number","description":"Ads profile used.","example":null},{"type":"null"}]},"advertiserAccountId":{"anyOf":[{"type":"string","description":"The Ads v1 account ID mapped to.","example":null},{"type":"null"}]},"fields":{"anyOf":[{"type":"array","description":"The actual fixed field combination (as returned).","example":null},{"type":"null"}]},"totalRows":{"anyOf":[{"type":"integer","description":"The total number of rows after merging; 0 is a legally empty report.","example":null},{"type":"null"}]},"dataFiles[]":{"type":"array","description":"Local CSV slice file and row number.","example":null},"preview[]":{"type":"array","description":"Results preview.","example":null},"resumeHint":{"anyOf":[{"type":"object","description":"Continue parameters during STILL_PROCESSING.","example":null},{"type":"null"}]},"_cacheable":{"anyOf":[{"type":"boolean","description":"Successful results are cached for 24 hours; failed/incomplete is false.","example":null},{"type":"null"}]},"part":{"anyOf":[{"type":"integer","description":"Fragment serial number.","example":null},{"type":"null"}]},"path":{"anyOf":[{"type":"string","description":"Local CSV file path.","example":null},{"type":"null"}]},"rowCount":{"anyOf":[{"type":"integer","description":"The number of rows in this shard.","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token cost reported by the upstream provider.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/amazon/policyFeedDetail":{"post":{"operationId":"nexscope_data_amazon_policy_feed_detail","x-nexscope-slug":"data-amazon-policy-feed-detail","summary":"Amazon ABA & Business Insights: policy Feed Detail API","description":"Amazon ABA & Business Insights: policy Feed Detail API.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Information record ID (32-bit string), `data[].id` from list interface response."}},"required":["id"],"additionalProperties":true},"example":{"id":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"type":{"anyOf":[{"type":"string","description":"The response type is fixed to `stdoutWorkbenches`, and the front-end renders `stdout` according to Markdown.","example":null},{"type":"null"}]},"stdout":{"anyOf":[{"type":"string","description":"The complete text of the information, in Markdown format.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Information title.","example":null},{"type":"null"}]},"summaryZh":{"anyOf":[{"type":"string","description":"AI-generated Chinese summary, summarizing 1-3 sentences.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"The total processing time, in milliseconds.","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Token consumption.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/et/batchVideoDetail":{"post":{"operationId":"nexscope_data_et_batch_video_detail","x-nexscope-slug":"data-et-batch-video-detail","summary":"TikTok Intelligence ET: batch Video Detail API","description":"TikTok Intelligence ET: batch Video Detail API.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"videoIds":{"type":"array","description":"TikTok video ID list, up to 1000. Can be obtained from video list query results","items":{"type":"string"},"maxItems":1000},"videoUrls":{"type":"array","description":"List of TikTok video URLs (in the form of `https://www.tiktok.com/@<unique_id>/video/<videoId>` or `https://www.tiktok.com/video/<videoId>`), up to 1,000; the server extracts the last `videoId` from each URL and merges it into `videoIds`, which is not mutually exclusive with `videoIds`","items":{"type":"string"},"maxItems":1000}},"required":[],"additionalProperties":true},"example":{"videoIds":["7030893014180531462","6768504823336815877","7425631540178160939"]}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of videos returned","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Render column definition (each item contains `field`/`title`/`cellType`/`filterable`/`sortable`)","example":null},{"type":"null"}]},"videos":{"anyOf":[{"type":"array","description":"Video details list (see video object field below for details)","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Consume token","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendering style (such as `tableListWorkbenches`)","example":null},{"type":"null"}]},"videoId":{"anyOf":[{"type":"string","description":"Video ID","example":null},{"type":"null"}]},"videoDesc":{"anyOf":[{"type":"string","description":"Video description/copywriting","example":null},{"type":"null"}]},"officialUrl":{"anyOf":[{"type":"string","description":"TikTok official video address","example":null},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","description":"Video cover URL","example":null},{"type":"null"}]},"duration":{"anyOf":[{"type":"integer","description":"Video duration (seconds)","example":null},{"type":"null"}]},"width":{"anyOf":[{"type":"string","description":"Video width (px)","example":null},{"type":"null"}]},"height":{"anyOf":[{"type":"string","description":"Video height (px)","example":null},{"type":"null"}]},"ratio":{"anyOf":[{"type":"string","description":"Video definition (such as 540p/720p)","example":null},{"type":"null"}]},"dataSize":{"anyOf":[{"type":"string","description":"Video file size","example":null},{"type":"null"}]},"createDate":{"anyOf":[{"type":"string","description":"Video release date (yyyy-MM-dd HH:mm:ss)","example":null},{"type":"null"}]},"userId":{"anyOf":[{"type":"string","description":"Expert ID","example":null},{"type":"null"}]},"uniqueId":{"anyOf":[{"type":"string","description":"TikTok account ID (unique_id)","example":null},{"type":"null"}]},"avatar":{"anyOf":[{"type":"string","description":"Master avatar URL","example":null},{"type":"null"}]},"totalViewsCnt":{"anyOf":[{"type":"integer","description":"Total views","example":null},{"type":"null"}]},"totalViews1dCnt":{"anyOf":[{"type":"integer","description":"Play volume increase in the last day","example":null},{"type":"null"}]},"totalViews7dCnt":{"anyOf":[{"type":"integer","description":"Increase in playback volume in the last 7 days","example":null},{"type":"null"}]},"totalViews30dCnt":{"anyOf":[{"type":"integer","description":"Increase in playback volume in the last 30 days","example":null},{"type":"null"}]},"totalDiggCnt":{"anyOf":[{"type":"integer","description":"Total likes","example":null},{"type":"null"}]},"totalDigg1dCnt":{"anyOf":[{"type":"integer","description":"Increase in likes in the last 1 day","example":null},{"type":"null"}]},"totalDigg7dCnt":{"anyOf":[{"type":"integer","description":"Increase in likes in the last 7 days","example":null},{"type":"null"}]},"totalDigg30dCnt":{"anyOf":[{"type":"integer","description":"Increase in likes in the last 30 days","example":null},{"type":"null"}]},"totalCommentsCnt":{"anyOf":[{"type":"integer","description":"Total comments","example":null},{"type":"null"}]},"totalSharesCnt":{"anyOf":[{"type":"integer","description":"Total shares","example":null},{"type":"null"}]},"totalFavoritesCnt":{"anyOf":[{"type":"integer","description":"Total collections","example":null},{"type":"null"}]},"totalVideoSaleCnt":{"anyOf":[{"type":"integer","description":"Video sales (pieces, estimate)","example":null},{"type":"null"}]},"totalVideoSaleGmvAmt":{"anyOf":[{"type":"integer","description":"Video sales GMV (estimated amount)","example":null},{"type":"null"}]},"salesFlagText":{"anyOf":[{"type":"string","description":"Whether to bring goods video (yes/no)","example":null},{"type":"null"}]},"isAdText":{"anyOf":[{"type":"string","description":"Whether to stream video (yes/no)","example":null},{"type":"null"}]},"createdByAiText":{"anyOf":[{"type":"string","description":"Whether AI video (yes/no/unknown)","example":null},{"type":"null"}]},"productCategoryList":{"anyOf":[{"type":"string","description":"Associated product classification (JSON string, empty means `[]`)","example":null},{"type":"null"}]},"videoProducts":{"anyOf":[{"type":"string","description":"Product with video (JSON string, empty means `[]`)","example":null},{"type":"null"}]},"region":{"anyOf":[{"type":"string","description":"The region code where the video is located","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Data source (such as Tiktok)","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/et/listSeller":{"post":{"operationId":"nexscope_data_et_list_seller","x-nexscope-slug":"data-et-list-seller","summary":"TikTok Intelligence ET: list Seller API","description":"TikTok Intelligence ET: list Seller API.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string","description":"area. Optional values: US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (UK), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France)"},"categoryId":{"type":"string","description":"Store-level category ID. Maximum length 1000"},"categoryL2Id":{"type":"string","description":"Store secondary category ID. Maximum length 1000"},"categoryL3Id":{"type":"string","description":"The third-level category ID of the store. Maximum length 1000"},"minTotalSaleGmv30dAmt":{"type":"number","description":"GMV screening in the past 30 days (minimum value)"},"maxTotalSaleGmv30dAmt":{"type":"number","description":"GMV filtering in the past 30 days (maximum value)"},"salesTrendFlag":{"type":"integer","description":"Sales trend in the past 7 days: 0=stable, 1=increasing, 2=declining"},"fromFlag":{"type":"integer","description":"Store source: 1=local store, 2=cross-border store"},"salesFlag":{"type":"integer","description":"Main delivery methods: 1=video, 2=live broadcast"},"minFirstCrawlDt":{"type":"integer","description":"Estimated shelf time filter (minimum value), yyyyMMdd format (for example, 20240101 represents 2024-01-01)"},"maxFirstCrawlDt":{"type":"integer","description":"Estimated shelf time filter (maximum value), yyyyMMdd format"},"sellerSortField":{"type":"integer","description":"Sorting fields: 1=total sales (total_sale_cnt), 2=total sales (total_sale_gmv_amt), 3=average price of product SKU in the store (spu_avg_price)","default":2},"sortType":{"type":"integer","description":"Sorting method: 0=ascending order (asc), 1=descending order (desc)","default":1},"pageNum":{"type":"integer","description":"Pagination page number, starting from 1","default":1},"pageSize":{"type":"integer","description":"Number of items per page. **must be a multiple of 10, the maximum is 100**; the upper limit of a single page in the official interface is 10, internally it is 10 after multiple pulls per page and then merged","default":50}},"required":["region"],"additionalProperties":true},"example":{"region":"US","sellerSortField":2,"sortType":1,"pageSize":20,"pageNum":1}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records","example":null},{"type":"null"}]},"sellers":{"anyOf":[{"type":"array","description":"Store list (see store fields below for details)","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendering style","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Consume token","example":null},{"type":"null"}]},"sellerId":{"anyOf":[{"type":"string","description":"Store ID","example":null},{"type":"null"}]},"sellerName":{"anyOf":[{"type":"string","description":"Store name","example":null},{"type":"null"}]},"sellerLink":{"anyOf":[{"type":"string","description":"Store link","example":null},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","description":"Store cover address","example":null},{"type":"null"}]},"region":{"anyOf":[{"type":"string","description":"area","example":null},{"type":"null"}]},"categoryId":{"anyOf":[{"type":"string","description":"First level classification ID","example":null},{"type":"null"}]},"categoryL2Id":{"anyOf":[{"type":"string","description":"Secondary classification ID","example":null},{"type":"null"}]},"categoryL3Id":{"anyOf":[{"type":"string","description":"Third level classification ID","example":null},{"type":"null"}]},"totalSaleCnt":{"anyOf":[{"type":"integer","description":"total sales","example":null},{"type":"null"}]},"totalSale1dCnt":{"anyOf":[{"type":"integer","description":"Sales volume in the last day (incremental)","example":null},{"type":"null"}]},"totalSale7dCnt":{"anyOf":[{"type":"integer","description":"Sales volume in the last 7 days (incremental)","example":null},{"type":"null"}]},"totalSale30dCnt":{"anyOf":[{"type":"integer","description":"Sales volume in the last 30 days (incremental)","example":null},{"type":"null"}]},"totalSale90dCnt":{"anyOf":[{"type":"integer","description":"Sales volume in the last 90 days (incremental)","example":null},{"type":"null"}]},"totalSaleGmvAmt":{"anyOf":[{"type":"number","description":"total sales","example":null},{"type":"null"}]},"totalSaleGmv1dAmt":{"anyOf":[{"type":"number","description":"Sales in the last day (incremental)","example":null},{"type":"null"}]},"totalSaleGmv7dAmt":{"anyOf":[{"type":"number","description":"Sales in the last 7 days (incremental)","example":null},{"type":"null"}]},"totalSaleGmv30dAmt":{"anyOf":[{"type":"number","description":"Sales in the last 30 days (incremental)","example":null},{"type":"null"}]},"totalSaleGmv90dAmt":{"anyOf":[{"type":"number","description":"Sales in the last 90 days (incremental)","example":null},{"type":"null"}]},"followersCount":{"anyOf":[{"type":"integer","description":"Number of fans","example":null},{"type":"null"}]},"rating":{"anyOf":[{"type":"number","description":"Rating","example":null},{"type":"null"}]},"reviewCount":{"anyOf":[{"type":"integer","description":"Number of reviews","example":null},{"type":"null"}]},"positiveFeedbackRate":{"anyOf":[{"type":"number","description":"Positive rating","example":null},{"type":"null"}]},"responseRate":{"anyOf":[{"type":"number","description":"response rate","example":null},{"type":"null"}]},"deliveryRate":{"anyOf":[{"type":"integer","description":"Delivery rate","example":null},{"type":"null"}]},"totalProductCnt":{"anyOf":[{"type":"integer","description":"Historical number of items in the store (including removal from shelves)","example":null},{"type":"null"}]},"totalCrawlProductCnt":{"anyOf":[{"type":"integer","description":"Number of items in store","example":null},{"type":"null"}]},"spuAvgPrice":{"anyOf":[{"type":"number","description":"Average price of product SKU in the store","example":null},{"type":"null"}]},"minPrice":{"anyOf":[{"type":"integer","description":"lowest price","example":null},{"type":"null"}]},"maxPrice":{"anyOf":[{"type":"integer","description":"highest price","example":null},{"type":"null"}]},"totalIflCnt":{"anyOf":[{"type":"integer","description":"Total number of people carrying goods","example":null},{"type":"null"}]},"totalVideoCnt":{"anyOf":[{"type":"integer","description":"Total number of videos delivered","example":null},{"type":"null"}]},"totalLiveCnt":{"anyOf":[{"type":"integer","description":"Total live broadcasts","example":null},{"type":"null"}]},"salesFlagText":{"anyOf":[{"type":"string","description":"Main delivery methods","example":null},{"type":"null"}]},"salesTrendFlagText":{"anyOf":[{"type":"string","description":"sales trends","example":null},{"type":"null"}]},"shopIdentityLabel":{"anyOf":[{"type":"string","description":"store logo","example":null},{"type":"null"}]},"shopTypeText":{"anyOf":[{"type":"string","description":"Is it a brand store?","example":null},{"type":"null"}]},"fromFlagText":{"anyOf":[{"type":"string","description":"Cross-border identification","example":null},{"type":"null"}]},"productCategoryList":{"anyOf":[{"type":"string","description":"Product classification","example":null},{"type":"null"}]},"mostProductCategoryList":{"anyOf":[{"type":"string","description":"TOP1 product classification","example":null},{"type":"null"}]},"firstCrawlDt":{"anyOf":[{"type":"integer","description":"Estimated release time, yyyyMMdd format (for example, 20240101 represents 2024-01-01)","example":null},{"type":"null"}]},"userId":{"anyOf":[{"type":"string","description":"Master UID","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Product source","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/et/listSellerProduct":{"post":{"operationId":"nexscope_data_et_list_seller_product","x-nexscope-slug":"data-et-list-seller-product","summary":"TikTok Intelligence ET: list Seller Product API","description":"TikTok Intelligence ET: list Seller Product API.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sellerId":{"type":"string","description":"Store ID (TikTok Shop store ID). Maximum length 1000. Obtained from the returned results of the \"ET TikTok Store Search\" or \"ET TikTok Store Details\" skills"},"sellerProductSortField":{"type":"integer","description":"List sorting fields: 1=Total sales (total_sale_cnt), 2=Total sales (total_sale_gmv_amt), 3=SPU average price (spu_avg_price), 4=7-day sales (total_sale_7d_cnt), 5=7-day sales (total_sale_gmv_7d_amt)","default":1},"sortType":{"type":"integer","description":"Sorting order: 0=ascending (asc), 1=descending (desc)","default":1},"pageSize":{"type":"integer","description":"Number of items per page. **must be a multiple of 10, the maximum is 100**; the upper limit of a single page in the official interface is 10, internally it is 10 after multiple pulls per page and then merged","default":50},"pageNum":{"type":"integer","description":"Pagination page number, starting from 1","default":1}},"required":["sellerId"],"additionalProperties":true},"example":{"sellerId":"7495514739648989419","sellerProductSortField":1,"sortType":1,"pageSize":20,"pageNum":1}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records","example":null},{"type":"null"}]},"products":{"anyOf":[{"type":"array","description":"Store product list (see product fields below for details)","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendering style","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Consume token","example":null},{"type":"null"}]},"productId":{"anyOf":[{"type":"string","description":"Product unique identification ID","example":null},{"type":"null"}]},"asin":{"anyOf":[{"type":"string","description":"Product ID (same as productId)","example":null},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string","description":"Product image URL","example":null},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","description":"Cover image URL","example":null},{"type":"null"}]},"productImageUrls":{"anyOf":[{"type":"array","description":"Product image URL list","example":null},{"type":"null"}]},"price":{"anyOf":[{"type":"number","description":"Product price","example":null},{"type":"null"}]},"spuAvgPrice":{"anyOf":[{"type":"number","description":"SPU average price","example":null},{"type":"null"}]},"minPrice":{"anyOf":[{"type":"number","description":"lowest price","example":null},{"type":"null"}]},"maxPrice":{"anyOf":[{"type":"number","description":"highest price","example":null},{"type":"null"}]},"currency":{"anyOf":[{"type":"string","description":"Currency","example":null},{"type":"null"}]},"totalSaleCnt":{"anyOf":[{"type":"integer","description":"total sales","example":null},{"type":"null"}]},"totalSale1dCnt":{"anyOf":[{"type":"integer","description":"Total sales in 1 day (incremental)","example":null},{"type":"null"}]},"totalSale7dCnt":{"anyOf":[{"type":"integer","description":"Total sales within 7 days (incremental)","example":null},{"type":"null"}]},"totalSale15dCnt":{"anyOf":[{"type":"integer","description":"Total sales (incremental) within 15 days","example":null},{"type":"null"}]},"totalSale30dCnt":{"anyOf":[{"type":"integer","description":"Total sales in 30 days (incremental)","example":null},{"type":"null"}]},"totalSale60dCnt":{"anyOf":[{"type":"integer","description":"Total sales in 60 days (incremental)","example":null},{"type":"null"}]},"totalSale90dCnt":{"anyOf":[{"type":"integer","description":"Total sales in 90 days (incremental)","example":null},{"type":"null"}]},"monthlySalesUnits":{"anyOf":[{"type":"integer","description":"monthly sales","example":null},{"type":"null"}]},"totalSaleGmvAmt":{"anyOf":[{"type":"number","description":"total sales","example":null},{"type":"null"}]},"totalSaleGmv1dAmt":{"anyOf":[{"type":"number","description":"Total sales in 1 day (incremental)","example":null},{"type":"null"}]},"totalSaleGmv7dAmt":{"anyOf":[{"type":"number","description":"Total sales (incremental) within 7 days","example":null},{"type":"null"}]},"totalSaleGmv15dAmt":{"anyOf":[{"type":"number","description":"Total sales in 15 days (incremental)","example":null},{"type":"null"}]},"totalSaleGmv30dAmt":{"anyOf":[{"type":"number","description":"Total sales in 30 days (incremental)","example":null},{"type":"null"}]},"totalSaleGmv60dAmt":{"anyOf":[{"type":"number","description":"Total sales in 60 days (incremental)","example":null},{"type":"null"}]},"totalSaleGmv90dAmt":{"anyOf":[{"type":"number","description":"Total sales in 90 days (incremental)","example":null},{"type":"null"}]},"productRating":{"anyOf":[{"type":"number","description":"product rating","example":null},{"type":"null"}]},"ratings":{"anyOf":[{"type":"integer","description":"Number of comments","example":null},{"type":"null"}]},"reviewCount":{"anyOf":[{"type":"integer","description":"Number of comments","example":null},{"type":"null"}]},"productCommissionRate":{"anyOf":[{"type":"number","description":"Product commission ratio (decimal, such as 0.05 means 5%)","example":null},{"type":"null"}]},"categoryName":{"anyOf":[{"type":"string","description":"Product category name","example":null},{"type":"null"}]},"categoryIds":{"anyOf":[{"type":"array","description":"Product category ID list","example":null},{"type":"null"}]},"salesFlagText":{"anyOf":[{"type":"string","description":"How to bring goods","example":null},{"type":"null"}]},"salesTrendFlagText":{"anyOf":[{"type":"string","description":"sales trend tag","example":null},{"type":"null"}]},"firstCrawlDt":{"anyOf":[{"type":"integer","description":"Release date (yyyyMMdd format, such as 20240504)","example":null},{"type":"null"}]},"availableDate":{"anyOf":[{"type":"string","description":"Release time (timestamp/date)","example":null},{"type":"null"}]},"discount":{"anyOf":[{"type":"string","description":"discount information","example":null},{"type":"null"}]},"offMarkText":{"anyOf":[{"type":"string","description":"Is there a discount mark?","example":null},{"type":"null"}]},"freeShippingText":{"anyOf":[{"type":"string","description":"Is it free shipping?","example":null},{"type":"null"}]},"isSShopText":{"anyOf":[{"type":"string","description":"Is it an S store?","example":null},{"type":"null"}]},"salePropsInfo":{"anyOf":[{"type":"array","description":"Sales attribute information (including propId/propName/salePropValues[propValueId/propValue/image])","example":null},{"type":"null"}]},"region":{"anyOf":[{"type":"string","description":"area code","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Product source","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/et/listProductVideo":{"post":{"operationId":"nexscope_data_et_list_product_video","x-nexscope-slug":"data-et-list-product-video","summary":"TikTok Intelligence ET: list Product Video API","description":"TikTok Intelligence ET: list Product Video API.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"productId":{"type":"string","description":"Product ID. Maximum length 1000"},"userId":{"type":"string","description":"Expert ID is used to filter the delivery videos of specific experts. Maximum length 1000"},"productVideoSortField":{"type":"integer","description":"Sorting fields: 1=play volume, 2=likes, 3=shares, 4=video sales, 5=video sales GMV, 6=release time. Default `1`","default":1},"sortType":{"type":"integer","description":"Sorting method: 0=ascending order, 1=descending order. Default `1`","default":1},"minCreateTime":{"type":"integer","description":"Video release time interval - start (second-level timestamp)"},"maxCreateTime":{"type":"integer","description":"Video publishing time interval-end (second-level timestamp)"},"pageNum":{"type":"integer","description":"Pagination page number. Default `1`","default":1},"pageSize":{"type":"integer","description":"The number of paging entries (must be a multiple of 10, maximum 100; the upper limit of a single page in the official interface is 10, internally press 10 to pull multiple times per page and then merge). Default `50`","default":50}},"required":["productId"],"additionalProperties":true},"example":{"productId":"1729382310407603945","productVideoSortField":1,"sortType":1,"pageSize":20}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"total":{"anyOf":[{"type":"integer","description":"Number of records","example":null},{"type":"null"}]},"data":{"anyOf":[{"type":"array","description":"Video list (see video object below)","example":null},{"type":"null"}]},"columns":{"anyOf":[{"type":"array","description":"Rendered columns","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Rendering style","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"Consume token","example":null},{"type":"null"}]},"videoId":{"anyOf":[{"type":"string","description":"Video ID","example":null},{"type":"null"}]},"productId":{"anyOf":[{"type":"string","description":"Product ID","example":null},{"type":"null"}]},"userId":{"anyOf":[{"type":"string","description":"Expert ID","example":null},{"type":"null"}]},"videoDesc":{"anyOf":[{"type":"string","description":"Video description","example":null},{"type":"null"}]},"officialUrl":{"anyOf":[{"type":"string","description":"TikTok official video address","example":null},{"type":"null"}]},"covet":{"anyOf":[{"type":"integer","description":"Number of shares","example":null},{"type":"null"}]},"totalFavoritesCnt":{"anyOf":[{"type":"integer","description":"Number of collections","example":null},{"type":"null"}]},"totalVideoSaleCnt":{"anyOf":[{"type":"integer","description":"Video sales (estimated)","example":null},{"type":"null"}]},"totalVideoSaleGmvAmt":{"anyOf":[{"type":"integer","description":"Video sales GMV (estimate)","example":null},{"type":"null"}]},"hashTag":{"anyOf":[{"type":"string","description":"Hashtag","example":null},{"type":"null"}]},"createDate":{"anyOf":[{"type":"string","description":"Video release date","example":null},{"type":"null"}]},"region":{"anyOf":[{"type":"string","description":"area code","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Product source","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/kd/livestream/detail":{"post":{"operationId":"nexscope_data_kd_livestream_detail","x-nexscope-slug":"data-kd-livestream-detail","summary":"TikTok Intelligence KD: livestream/detail API","description":"TikTok Intelligence KD: livestream/detail API.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"livestreamId":{"type":"string","description":"Target live broadcast unique ID, such as `7661409374878878494`, usually `livestream_id` from the list; maximum length 1000"},"region":{"type":"string","description":"Region/market code, such as `US`; maximum length 1000"},"dateRange":{"type":"string","description":"Time range, such as `last7Day` (last 7 days), `last30Day` (last 30 days); maximum length 1000"},"language":{"type":"string","description":"Return language, for example `zh-CN`, `en-US`"},"currency":{"type":"string","description":"Currency unit, such as `USD`"}},"required":["livestreamId"],"additionalProperties":true},"example":{"livestreamId":"7661409374878878494","region":"US","dateRange":"last7Day","currency":"USD"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"array","description":"Live broadcast details data, always an array of 1 element when successful","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"The deduction token for this call is fixed to `14000`","example":null},{"type":"null"}]},"livestream_id":{"anyOf":[{"type":"string","description":"Live broadcast unique ID, consistent with the requested `livestreamId`","example":null},{"type":"null"}]},"livestream_title":{"anyOf":[{"type":"string","description":"Live title, such as `24 HOUR STREAM`","example":null},{"type":"null"}]},"creator_id":{"anyOf":[{"type":"string","description":"The unique ID of the expert (string, to avoid loss of large integer precision)","example":null},{"type":"null"}]},"creator_handle":{"anyOf":[{"type":"string","description":"Expert username/handle, such as `pokepiglt`","example":null},{"type":"null"}]},"livestream_start_time":{"anyOf":[{"type":"integer","description":"Live broadcast start time, epoch milliseconds","example":null},{"type":"null"}]},"livestream_end_time":{"anyOf":[{"type":"integer","description":"Live broadcast end time, epoch milliseconds","example":null},{"type":"null"}]},"livestream_duration":{"anyOf":[{"type":"integer","description":"Live broadcast duration, unit seconds","example":null},{"type":"null"}]},"record_type":{"anyOf":[{"type":"string","description":"Record type, such as `SHORT`","example":null},{"type":"null"}]},"viewers":{"anyOf":[{"type":"integer","description":"Number of viewers; use `viewers` for details and `views` for lists","example":null},{"type":"null"}]},"revenue":{"anyOf":[{"type":"number","description":"Live sales/GMV, returned by requested `currency`; details are of type numeric","example":null},{"type":"null"}]},"gpm":{"anyOf":[{"type":"number","description":"GMV per mille, GMV per thousand impressions; details exclusive","example":null},{"type":"null"}]},"product_number":{"anyOf":[{"type":"integer","description":"Number of goods delivered live","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/kd/shop/rank":{"post":{"operationId":"nexscope_data_kd_shop_rank","x-nexscope-slug":"data-kd-shop-rank","summary":"TikTok Intelligence KD: shop/rank API","description":"TikTok Intelligence KD: shop/rank API.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string","description":"Region/market code, such as `US`; maximum length 1000"},"dateRange":{"type":"string","description":"Time range, such as `last7Day`, `last30Day`; maximum length 1000"},"pageNumber":{"type":"integer","description":"Page number, value 1-5; out of range returns `errcode 501`"},"pageSize":{"type":"integer","description":"Quantity per page, value 5-100"},"language":{"type":"string","description":"Return language, such as `zh-CN`, `en-US`; maximum length 1000"},"currency":{"type":"string","description":"Currency unit, such as `USD`; maximum length 1000"},"category_ids":{"type":"array","description":"Category ID list filtering; after specifying, return the transaction amount under the corresponding category","items":{"type":"string"}},"revenue_range":{"type":"string","description":"Transaction amount / GMV range, left closed and right open"},"shop_type":{"type":"string","description":"Store type: `BRAND` (brand) or `RETAILER` (retailer)"},"sortField":{"type":"object","description":"Sorting conditions; when not sorting, pass an empty object `{}`"},"category_id":{"type":"string","description":"Category ID, which can further limit the returned category dimensions"}},"required":[],"additionalProperties":true},"example":{"region":"US","dateRange":"last7Day","pageSize":10,"pageNumber":1,"currency":"USD"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"array","description":"Store list list or 1-element details array","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"The deduction token for this call is fixed to `14000`","example":null},{"type":"null"}]},"rank":{"anyOf":[{"type":"integer","description":"Ranking position, 1 is the highest","example":null},{"type":"null"}]},"shop_name":{"anyOf":[{"anyOf":[{"type":"string","description":"Store name","example":null},{"type":"null"}]},{"type":"null"}]},"shop_id":{"anyOf":[{"anyOf":[{"type":"string","description":"Store unique ID (string, to avoid loss of large integer precision)","example":null},{"type":"null"}]},{"type":"null"}]},"shop_type":{"anyOf":[{"type":"string","description":"Store type, such as `BRAND`","example":null},{"type":"null"}]},"revenue":{"anyOf":[{"anyOf":[{"type":"number","description":"Total sales/GMV by requested `currency` currency","example":null},{"type":"null"}]},{"type":"null"}]},"sales_volumn":{"anyOf":[{"anyOf":[{"type":"integer","description":"Sales volume, field spelled `volumn`","example":null},{"type":"null"}]},{"type":"null"}]},"on_sell_product_count":{"anyOf":[{"type":"integer","description":"Number of items on sale","example":null},{"type":"null"}]},"unit_price":{"anyOf":[{"anyOf":[{"type":"number","description":"Unit price in requested `currency` currency","example":null},{"type":"null"}]},{"type":"null"}]},"revenue_growth_rate":{"anyOf":[{"type":"number","description":"Sales growth rate (%), can be positive or negative","example":null},{"type":"null"}]},"self_promotion_revenue":{"anyOf":[{"type":"number","description":"Self-operated/self-promoted sales","example":null},{"type":"null"}]},"affiliate_revenue":{"anyOf":[{"anyOf":[{"type":"number","description":"Master Distribution Sales","example":null},{"type":"null"}]},{"type":"null"}]},"shopping_mall_revenue":{"anyOf":[{"type":"number","description":"Mall sales","example":null},{"type":"null"}]},"seller_type":{"anyOf":[{"type":"string","description":"Store/seller type, such as `BRAND`; use `seller_type` for details, not `shop_type`","example":null},{"type":"null"}]},"region":{"anyOf":[{"type":"string","description":"Region/market such as `US`","example":null},{"type":"null"}]},"product_number":{"anyOf":[{"type":"integer","description":"Number of items on sale","example":null},{"type":"null"}]},"self_account_revenue":{"anyOf":[{"type":"number","description":"Self-operated/self-broadcast self-promoted sales; use `self_account_revenue` for details","example":null},{"type":"null"}]},"shoppingmall_revenue":{"anyOf":[{"type":"number","description":"Mall sales; there is no underscore between `shopping` and `mall` in the detail field name","example":null},{"type":"null"}]},"creator_number":{"anyOf":[{"type":"integer","description":"Number of collaborations with experts","example":null},{"type":"null"}]},"video_number":{"anyOf":[{"type":"integer","description":"Number of associated videos","example":null},{"type":"null"}]},"live_number":{"anyOf":[{"type":"integer","description":"Number of associated live broadcasts","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/kd/video/rank":{"post":{"operationId":"nexscope_data_kd_video_rank","x-nexscope-slug":"data-kd-video-rank","summary":"TikTok Intelligence KD: video/rank API","description":"TikTok Intelligence KD: video/rank API.","tags":["E-commerce Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string","description":"Region/market code, such as `US`"},"dateRange":{"type":"string","description":"Time range, such as `last7Day`, `last30Day`"},"pageNumber":{"type":"integer","description":"Page number, value 1-5"},"pageSize":{"type":"integer","description":"Quantity per page, value 5-100"},"language":{"type":"string","description":"Return language, for example `zh-CN`, `en-US`"},"currency":{"type":"string","description":"Currency unit, such as `USD`"},"category_id":{"type":"string","description":"Category ID filter"},"shop_id":{"type":"string","description":"Store ID filter"},"creator_id":{"type":"string","description":"Expert ID filtering"},"product_id":{"type":"string","description":"Product ID filter"},"revenue_range":{"type":"string","description":"GMV ranges such as `1-100`, `>1000`, `<100`"},"followers_range":{"type":"string","description":"Filter by number of fans"},"ads_roas":{"type":"number","description":"Advertising ROAS filtering"},"sortField":{"type":"object","description":"GMV sort criteria, such as `{\"field\":\"revenue\",\"type\":\"DESC\"}`"}},"required":[],"additionalProperties":true},"example":{"region":"US","dateRange":"last7Day","revenue_range":"1-100","sortField":{"field":"revenue","type":"DESC"},"pageSize":10,"pageNumber":1,"currency":"USD"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"data":{"anyOf":[{"type":"array","description":"List or detailed data","example":null},{"type":"null"}]},"costToken":{"anyOf":[{"type":"integer","description":"The deduction token for this call is usually `14000`","example":null},{"type":"null"}]},"video_id":{"anyOf":[{"anyOf":[{"type":"string","description":"Video ID, string format to avoid loss of precision for large integers","example":null},{"type":"null"}]},{"type":"null"}]},"video_title":{"anyOf":[{"anyOf":[{"type":"string","description":"Video title/copywriting","example":null},{"type":"null"}]},{"type":"null"}]},"views":{"anyOf":[{"anyOf":[{"type":"integer","description":"Play volume","example":null},{"type":"null"}]},{"type":"null"}]},"digg_count":{"anyOf":[{"anyOf":[{"type":"integer","description":"Number of likes","example":null},{"type":"null"}]},{"type":"null"}]},"comment_count":{"anyOf":[{"anyOf":[{"type":"integer","description":"Number of comments","example":null},{"type":"null"}]},{"type":"null"}]},"share_count":{"anyOf":[{"anyOf":[{"type":"integer","description":"Number of shares","example":null},{"type":"null"}]},{"type":"null"}]},"revenue":{"anyOf":[{"anyOf":[{"type":"number","description":"Total Sales/GMV","example":null},{"type":"null"}]},{"type":"null"}]},"revenue_growth_rate":{"anyOf":[{"type":"number","description":"Sales growth rate (%), can be positive or negative","example":null},{"type":"null"}]},"ad":{"anyOf":[{"anyOf":[{"type":"integer","description":"Whether to run ads, 1=with ads, 0=without ads","example":null},{"type":"null"}]},{"type":"null"}]},"ad_view_ratio":{"anyOf":[{"anyOf":[{"type":"number","description":"Advertisement playback proportion (%)","example":null},{"type":"null"}]},{"type":"null"}]},"ad_revenue_ratio":{"anyOf":[{"type":"number","description":"Proportion of sales generated by advertising (%)","example":null},{"type":"null"}]},"ads_roas":{"anyOf":[{"anyOf":[{"type":"number","description":"Advertising ROAS","example":null},{"type":"null"}]},{"type":"null"}]},"belonged_creator_id":{"anyOf":[{"anyOf":[{"type":"string","description":"Attribution expert ID","example":null},{"type":"null"}]},{"type":"null"}]},"belonged_creator_handle":{"anyOf":[{"anyOf":[{"type":"string","description":"Attribution expert username","example":null},{"type":"null"}]},{"type":"null"}]},"creator_debut":{"anyOf":[{"type":"string","description":"Date of entry of the expert (`YYYY-MM-DD`)","example":null},{"type":"null"}]},"video_region":{"anyOf":[{"type":"string","description":"Video region, may be an empty string","example":null},{"type":"null"}]},"sales_volumn":{"anyOf":[{"type":"integer","description":"Sales volume, field spelled `volumn`","example":null},{"type":"null"}]},"video_gpm":{"anyOf":[{"type":"number","description":"Video GPM, or GMV per thousand plays","example":null},{"type":"null"}]},"ads_views":{"anyOf":[{"type":"integer","description":"Number of ad plays","example":null},{"type":"null"}]},"ad_cpa":{"anyOf":[{"type":"number","description":"Advertising CPA","example":null},{"type":"null"}]},"ads_period":{"anyOf":[{"type":"integer","description":"Advertising period (days)","example":null},{"type":"null"}]},"duration":{"anyOf":[{"type":"number","description":"Video duration (seconds)","example":null},{"type":"null"}]},"product_number":{"anyOf":[{"type":"integer","description":"Number of video related products","example":null},{"type":"null"}]},"type":{"anyOf":[{"type":"string","description":"Provider-specific render or payload type.","example":null},{"type":"null"}]},"title":{"anyOf":[{"type":"string","description":"Provider-specific response title.","example":null},{"type":"null"}]},"sourceType":{"anyOf":[{"type":"string","description":"Provider-specific source platform type.","example":null},{"type":"null"}]},"sourceTool":{"anyOf":[{"type":"string","description":"Provider-specific source tool name.","example":null},{"type":"null"}]},"costTime":{"anyOf":[{"type":"integer","description":"Execution time reported by the upstream provider.","example":null},{"type":"null"}]},"page":{"anyOf":[{"type":"integer","description":"Current page returned by the upstream provider.","example":null},{"type":"null"}]},"pageSize":{"anyOf":[{"type":"integer","description":"Page size returned by the upstream provider.","example":null},{"type":"null"}]},"pageItemCount":{"anyOf":[{"type":"integer","description":"Item count on the current page returned by the upstream provider.","example":null},{"type":"null"}]},"totalPage":{"anyOf":[{"type":"integer","description":"Total page count returned by the upstream provider.","example":null},{"type":"null"}]},"dataSnapshotMonth":{"anyOf":[{"type":"string","description":"Data snapshot month returned by the upstream provider.","example":null},{"type":"null"}]}},"required":[],"additionalProperties":true},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/profile":{"post":{"operationId":"social_tiktok_profile","x-nexscope-slug":"social-tiktok-profile","summary":"TikTok Profile","description":"Fetches public profile data for a TikTok user by their handle or user_id — useful for looking up a creator's identity, bio, and account stats. Returns a `user` object (display name, avatar URLs, bio/signature, verification status, bio link) and a `stats` object (followerCount, followingCount, heartCount/total likes, videoCount). This only returns profile metadata, not the user's actual videos or followers list. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Profile API View Pricing Scrapes a public TikTok profile 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"TikTok handle. You can pass handle or user_id."},"user_id":{"type":"string","description":"TikTok user id."},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":[],"additionalProperties":false,"anyOf":[{"required":["handle"]},{"required":["user_id"]}]},"example":{"handle":"stoolpresidente"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"user":{"id":"6659752019493208069","shortId":"","uniqueId":"stoolpresidente","nickname":"Dave Portnoy","avatarLarger":"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~c5_1080x1080.jpeg?lk3s=a5d48078&nonce=58494&refresh_token=466ff0b92ed2f51170dbbdc2a30b9e9a&x-expires=1737921600&x-signature=uZnt1AjbwQ5pMTWNSV5hqw8QhMM%3D&shp=a5d48078&shcp=81f88b70","avatarMedium":"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~c5_720x720.jpeg?lk3s=a5d48078&nonce=18587&refresh_token=4c5e30ff3fe99ca813d9f79d74c41fb1&x-expires=1737921600&x-signature=6ropsZzca3J6jx%2BH49D%2BAgxMoe4%3D&shp=a5d48078&shcp=81f88b70","avatarThumb":"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~c5_100x100.jpeg?lk3s=a5d48078&nonce=56685&refresh_token=52483b418cbeceeaf2863a9fe0feb830&x-expires=1737921600&x-signature=xGLErTLpukZpmPcYw1ZBHJpPEbM%3D&shp=a5d48078&shcp=81f88b70","signature":"El Presidente/Barstool Sports Founder.","createTime":1550594547,"verified":true,"secUid":"MS4wLjABAAAAINC_ElRR-l1RCcnEjOZhNO-9wOzAMf-YHXqRY8vvG9bEhMRa6iu23TaE3JPZYXBD","ftc":false,"relation":0,"openFavorite":false,"bioLink":{"link":"https://www.barstoolsports.com/bios/Surviving-Barstool","risk":0},"commentSetting":0,"commerceUserInfo":{"commerceUser":false},"duetSetting":0,"stitchSetting":0,"privateAccount":false,"isADVirtual":false,"roomId":"","uniqueIdModifyTime":0,"ttSeller":false,"downloadSetting":0,"profileTab":{"showMusicTab":false,"showQuestionTab":false,"showPlayListTab":true},"followingVisibility":1,"recommendReason":"","nowInvitationCardUrl":"","nickNameModifyTime":0,"isEmbedBanned":false,"canExpPlaylist":true,"profileEmbedPermission":1,"language":"en","eventList":[]},"stats":{"followerCount":4100000,"followingCount":74,"heart":190400000,"heartCount":190400000,"videoCount":2017,"diggCount":0,"friendCount":52},"itemList":[]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/profile/region":{"post":{"operationId":"social_tiktok_profile_region","x-nexscope-slug":"social-tiktok-profile-region","summary":"TikTok Profile Region","description":"Returns the TikTok region code for a public profile, like `US` for United States or `MX` for Mexico. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Profile Region API View Pricing Gets the region/country code for a TikTok profile. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"TikTok handle"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"stoolpresidente"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"handle":"stoolpresidente","profile_url":"https://www.tiktok.com/@stoolpresidente","region":"US"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/user/audience":{"post":{"operationId":"social_tiktok_user_audience","x-nexscope-slug":"social-tiktok-user-audience","summary":"TikTok User's Audience Demographics","description":"Retrieves audience demographic data for a TikTok user, showing where their followers are located by country. Returns `audienceLocations`, an array of objects each containing `country`, `countryCode`, `count`, and `percentage`. Costs 26 credits per request. Get the audience demographics of a TikTok user. Right now you can only get the audience countries. \uD83D\uDEA8 Costs 26 credits per request. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok User's Audience Demographics API View Pricing Get audience countries for a TikTok user. Costs 26 credits per request. 26 credits per request\nRetrieves audience demographic data for a TikTok user, showing where their followers are located by country. Returns `audienceLocations`, an array of objects each containing `country`, `countryCode`, `count`, and `percentage`. Costs 26 credits per request. Get the audience demographics of a TikTok user. Right now you can only get the audience countries. \uD83D\uDEA8 Costs 26 credits per request.\n26 credits per request as documented; exception outcomes are not specified on this page.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"TikTok handle"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"shakira"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"audienceLocations":[{"country":"Mexico","countryCode":"MX","count":83,"percentage":"15.96%"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/collection/videos":{"post":{"operationId":"social_tiktok_collection_videos","x-nexscope-slug":"social-tiktok-collection-videos","summary":"TikTok Collection Videos","description":"Fetches the videos saved in a public TikTok collection, which TikTok also calls a playlist. Pass the collection URL. Returns `videos` using TikTok's native web video object format, including `id`, `desc`, `author`, `stats`, and `video`. To fetch the next page, pass the previous response's `max_cursor` as `cursor` when `has_more` is true. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Collection Videos API View Pricing Scrapes the videos in a public TikTok collection. Pass cursor to get more videos. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Public TikTok collection URL"},"cursor":{"type":"string","description":"Cursor to get more videos. Use max_cursor from the previous response."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.tiktok.com/@kibblemaster808/collection/Want-to-go-7665668414573546258"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"collection_id":"7665668414573546258","has_more":false,"max_cursor":"5","status_code":0,"status_msg":"","videos":[{"AIGCDescription":"","CategoryType":116,"IsHDBitrate":false,"ShowAIGC":true,"anchors":[{"description":"CapCut · Video Editor","type":54}],"author":{"id":"7506421330087576593","uniqueId":"miotravelapp","nickname":"miotravelapp"},"createTime":1784185607,"desc":"How often do you reckon they think about the Roman Empire? \uD83D\uDC08‍⬛","id":"7663018809392909588","stats":{"collectCount":18900,"commentCount":359,"diggCount":113000,"playCount":865200,"shareCount":15700},"video":{"duration":68,"height":1024,"width":576,"cover":"https://p19-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/oUYM7iBIKB1BL5CGgwAtAiwJEfLCFXAiX9IAEA~tplv-tiktokx-origin.image"}}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/profile/videos":{"post":{"operationId":"social_tiktok_profile_videos","x-nexscope-slug":"social-tiktok-profile-videos","summary":"TikTok Profile Videos","description":"Fetches videos posted by a TikTok user, sortable by latest or most popular — use this to get a creator's video feed or TikToks. Returns `aweme_list`, an array of video objects each containing `aweme_id`, `desc` (caption), `statistics` (play_count, digg_count/likes, comment_count, share_count, collect_count/saves), and `video` (download URLs, duration, cover image). Paginate with `max_cursor` from the previous response, keeping the same `region` and `sort_by` throughout a cursor chain. Known limitation: this feed is not an exhaustive inventory of a creator's public posts. TikTok's web page, single-post lookup, comments, and profile feed use different public sources and request contexts; a post may be retrievable through one and unavailable or missing through another. A missing feed item does not prove deletion, and a returned item does not guarantee browser playback in your country. Try the creator's country with a two-letter `region` code, restarting pagination when changing it, but country selection does not guarantee completeness. Repeated requests for the same page can also return different item sets. For campaign tracking, retain submitted post URLs/IDs and refresh them with `/v2/tiktok/video` rather than relying only on feed discovery. Retry a suspect page within a bounded budget and deduplicate by `aweme_id`; do not merge cursors from separate responses. [Examples and troubleshooting](https://docs.scrapecreators.com/tiktok-post-availability). Scrapes posts from a TikTok profile. TikTok can omit individual posts even after full pagination; region selection does not guarantee complete coverage. [Examples and troubleshooting](https://docs.scrapecreators.com/tiktok-post-availability). Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Profile Videos API View Pricing Get posts from a TikTok profile. Posts may be missing even after full pagination; region selection does not guarantee complete coverage. 1 credit per request\nWhether to include pinned posts. Defaults to true. Set to false to exclude posts marked as pinned, including with trim=true. Keep this value unchanged while paginating. Filtering can produce shorter or empty pages; follow has_more and max_cursor. Successful pages still cost 1 credit, including empty results.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"TikTok handle"},"user_id":{"type":"string","description":"TikTok user id. Use this for faster responses."},"sort_by":{"type":"string","enum":["latest","popular"],"description":"What to sort by"},"region":{"type":"string","description":"Country code passed to the profile-feed source. Defaults to US. If a profile should have videos but returns none, try another relevant two-letter country code. Changing this value does not guarantee that region-restricted posts will appear."},"include_pinned":{"type":"boolean","description":"Whether to include pinned posts. Defaults to true. Set to false to exclude posts marked as pinned, including with trim=true. Keep this value unchanged while paginating. Filtering can produce shorter or empty pages; follow has_more and max_cursor. Successful pages still cost 1 credit, including empty results."},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"},"max_cursor":{"type":"string","description":"Cursor to get more videos. Get 'max_cursor' from previous response."}},"required":["handle"],"additionalProperties":false},"example":{"handle":"stoolpresidente"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"aweme_list":[{"aweme_id":"7517114944362499342","desc":"You can say whatever you want about the WNBA is but it’s never boring","desc_language":"en","region":"US","statistics":{"aweme_id":"7517114944362499342","collect_count":1565,"comment_count":587,"digg_count":59605,"download_count":178,"forward_count":0,"lose_comment_count":0,"lose_count":0,"play_count":559925,"repost_count":0,"share_count":3424,"whatsapp_share_count":7},"video":{"CoverTsp":140.193500922967,"ai_dynamic_cover":{"uri":"tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H~tplv-tiktokx-origin.image?dr=9229&refresh_token=2a5a8daf&x-expires=1750370400&x-signature=PsejWQNXF%2BXPz%2BcpwWcdtCU9ddY%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=dynamic_cover"],"url_prefix":null},"ai_dynamic_cover_bak":{"uri":"tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H~tplv-tiktokx-origin.image?dr=9229&refresh_token=2a5a8daf&x-expires=1750370400&x-signature=PsejWQNXF%2BXPz%2BcpwWcdtCU9ddY%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=dynamic_cover"],"url_prefix":null},"animated_cover":{"uri":"tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H~tplv-tiktokx-origin.image?dr=9229&refresh_token=2a5a8daf&x-expires=1750370400&x-signature=PsejWQNXF%2BXPz%2BcpwWcdtCU9ddY%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=dynamic_cover"],"url_prefix":null},"big_thumbs":[{"duration":173.66667,"fext":"jpeg","img_num":174,"img_uris":["tos-maliva-p-0068c799-us/ogA4IiXKCF41BKBgnU9aS9ECP7zIZsMvTIivE"],"img_url":"","img_urls":["https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/ogA4IiXKCF41BKBgnU9aS9ECP7zIZsMvTIivE~tplv-noop.image?x-expires=1750371666&x-signature=1vtd4zbxRXSMA9ysRa68cfDAtLM%3D"],"img_x_len":5,"img_x_size":136,"img_y_len":5,"img_y_size":240,"interval":1,"uri":""}],"bit_rate":[{"HDR_bit":"","HDR_type":"","bit_rate":694328,"dub_infos":null,"fid_profile_labels":"","fps":30,"gear_name":"adapt_lower_720_2","is_bytevc1":2,"play_addr":{"data_size":15073438,"file_cs":"c:0-144831-d8fd","file_hash":"bade4c49b717e85095bf288836f2cf41","height":1280,"uri":"v12044gd0000d192fcnog65ouluk5f60","url_key":"v12044gd0000d192fcnog65ouluk5f60_bytevc2_720p_694328","url_list":["https://v45.tiktokcdn-eu.com/e026c66342e50c03deeb909ecf672f65/68548d52/video/tos/maliva/tos-maliva-ve-0068c799-us/oQOIKCXpeQMxlHgA9YwA8fQqQkIfj3UHkctEaC/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1356&bt=678&cs=5&ds=3&ft=XMeJiqqEm3aPD129DKoT3wUuDjGAMeF~O5&mime_type=video_mp4&qs=14&rc=ZWQ3OTk1ODMzZGU0NjY3aUBpM2lub3I5cmY1NDMzZzczNEAuNS8yMl4tX18xNmAuYzUwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=2025061906181346397E96BB7CA53550DC&btag=e00095000"],"url_prefix":null,"width":720},"quality_type":14,"video_extra":"{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 264024}, {\\\"time\\\": 2, \\\"offset\\\": 330253}, {\\\"time\\\": 3, \\\"offset\\\": 403843}, {\\\"time\\\": 4, \\\"offset\\\": 488694}, {\\\"time\\\": 5, \\\"offset\\\": 579736}, {\\\"time\\\": 10, \\\"offset\\\": 996199}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 96.728, \\\"v960\\\": 97.931, \\\"v864\\\": 98.683, \\\"v720\\\": 99.11}, \\\"ori\\\": {\\\"v1080\\\": 89.806, \\\"v960\\\": 91.917, \\\"v864\\\": 92.924, \\\"v720\\\": 95.104}}}\",\"ufq\":\"{\\\"enh\\\":66.187,\\\"playback\\\":{\\\"ori\\\":59.993,\\\"srv1\\\":64.978},\\\"src\\\":66.187,\\\"trans\\\":59.993,\\\"version\\\":\\\"v1.2\\\"}\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"398b00a3a79e904ef5421940da02ff2a\",\"dec_info\":\"\",\"gearvqm\":\"\"}"}],"bit_rate_audio":[],"cdn_url_expired":0,"cla_info":{"caption_infos":[{"caption_format":"webvtt","caption_length":2908,"cla_subtitle_id":7517115695181434000,"complaint_id":7517115695181434000,"expire":1752877266,"is_auto_generated":true,"is_original_caption":true,"lang":"eng-US","language_code":"en","language_id":2,"source_tag":"trantor,vv_counter,","sub_id":-1038776546,"sub_version":"1","subtitle_type":1,"translation_type":0,"translator_id":0,"url":"https://v16-cla.tiktokcdn.com/60e8a5e0d717490c9dbed68c8634a71e/687ac8d2/video/tos/maliva/tos-maliva-v-0068c799-us/62a5670f178245afb69f54becd90c657/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=19934&bt=9967&cs=0&ds=4&ft=asAJ4qqEm3aPD129DKoT3wUuDjGAMeF~O5&mime_type=video_mp4&qs=13&rc=M2lub3I5cmY1NDMzZzczNEBpM2lub3I5cmY1NDMzZzczNEAzMnJyMmRrYzZhLS1kMS9zYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=2025061906181346397E96BB7CA53550DC&btag=e00050000","url_list":["https://v16-cla.tiktokcdn.com/60e8a5e0d717490c9dbed68c8634a71e/687ac8d2/video/tos/maliva/tos-maliva-v-0068c799-us/62a5670f178245afb69f54becd90c657/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=19934&bt=9967&cs=0&ds=4&ft=asAJ4qqEm3aPD129DKoT3wUuDjGAMeF~O5&mime_type=video_mp4&qs=13&rc=M2lub3I5cmY1NDMzZzczNEBpM2lub3I5cmY1NDMzZzczNEAzMnJyMmRrYzZhLS1kMS9zYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=2025061906181346397E96BB7CA53550DC&btag=e00050000"],"variant":"big_caption"}],"captions_type":2,"creator_edited_caption_id":0,"enable_auto_caption":0,"has_original_audio":1,"hide_original_caption":false,"no_caption_reason":0,"original_language_info":{"can_translate_realtime":false,"can_translate_realtime_skip_translation_lang_check":true,"first_subtitle_time":340,"is_burnin_caption":false,"lang":"eng-US","language_code":"en","language_id":2,"original_caption_type":1},"vertical_positions":null},"cover":{"height":720,"uri":"tos-useast5-p-0068-tx/oUKFS4HhaMvXICUEIc1AgN7HEs9nivBIBC4iI","url_list":["https://p19-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oUKFS4HhaMvXICUEIc1AgN7HEs9nivBIBC4iI~tplv-tiktokx-cropcenter-q:300:400:q72.heic?dr=9232&refresh_token=e9f72667&x-expires=1750370400&x-signature=ASUnIL%2BG4pudjttwvChahXtZEW4%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=cover"],"url_prefix":null,"width":720},"cover_is_custom":true,"did_profile_labels":"","download_addr":{"data_size":24637995,"file_cs":"c:0-143697-b9bb","height":720,"uri":"v12044gd0000d192fcnog65ouluk5f60","url_list":["https://v45.tiktokcdn-eu.com/a304184e3539ff8ceb2bcea1b5cd67f6/68548d52/video/tos/maliva/tos-maliva-ve-0068c799-us/osMffQHg9IKplXhIekq8xUpGsKuYCjAqSQQEAH/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2216&bt=1108&cs=0&ds=3&ft=XMeJiqqEm3aPD129DKoT3wUuDjGAMeF~O5&mime_type=video_mp4&qs=0&rc=NDxmZGg1ZTw6NGlkNDM1N0BpM2lub3I5cmY1NDMzZzczNEAuMGEwMGBfXmExMWA2Y2I2YSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=2025061906181346397E96BB7CA53550DC&btag=e00095000"],"url_prefix":null,"width":720},"download_no_watermark_addr":{"data_size":23315651,"file_cs":"c:0-143697-b9bb","file_hash":"dc0d3f39653d5d1383f62d1c61ad9d5e","height":1024,"uri":"v12044gd0000d192fcnog65ouluk5f60","url_key":"v12044gd0000d192fcnog65ouluk5f60_h264_540p_1073989","url_list":["https://v45.tiktokcdn-eu.com/c8fc49d58f379d7e3ea4a564a2ddbde2/68548d52/video/tos/maliva/tos-maliva-ve-0068c799-us/o4u9CaIEvIMFiAHihBB4ng4sXQUWSFK1E1PvI/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2096&bt=1048&cs=0&ds=6&ft=XMeJiqqEm3aPD129DKoT3wUuDjGAMeF~O5&mime_type=video_mp4&qs=0&rc=Zmk5aDg8NzxkZTZoZ2QzOkBpM2lub3I5cmY1NDMzZzczNEBfNjY0Yy9jXjMxYF4yYTYwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=2025061906181346397E96BB7CA53550DC&btag=e00095000"],"url_prefix":null,"width":576},"duration":173675,"dynamic_cover":{"height":720,"uri":"tos-useast5-p-0068-tx/oIQCgk8IAMQfKA2ewUdC8XIH9HktlgfqjEpU2F","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oIQCgk8IAMQfKA2ewUdC8XIH9HktlgfqjEpU2F~tplv-tiktokx-origin.image?dr=9229&refresh_token=e20935f0&x-expires=1750370400&x-signature=%2FbtL8pYPrWExQyGJg5RtZyYoL0w%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=dynamic_cover"],"url_prefix":null,"width":720},"has_watermark":true,"height":1024,"is_bytevc1":0,"is_callback":true,"is_long_video":1,"meta":"{\"LoudnessRange\":\"4.2\",\"LoudnessRangeEnd\":\"-15.5\",\"LoudnessRangeStart\":\"-19.7\",\"MaximumMomentaryLoudness\":\"-9.6\",\"MaximumShortTermLoudness\":\"-14\",\"Version\":\"2\",\"VolumeInfoJson\":\"{\\\"MaximumMomentaryLoudness\\\":-9.6,\\\"MaximumShortTermLoudness\\\":-14,\\\"Metrics\\\":{\\\"Phase\\\":{\\\"RMSDownmixDiff\\\":-0.635},\\\"RMSStats\\\":{\\\"LTotal\\\":-18.202,\\\"Peak\\\":0.099,\\\"RTotal\\\":-25.112,\\\"LRDiff\\\":6.91},\\\"Version\\\":\\\"1.4.2\\\",\\\"AEDInfo\\\":{\\\"MusicRatio\\\":0,\\\"SingingRatio\\\":0.1,\\\"SpeechRatio\\\":0.89},\\\"AnchorLoudness\\\":{\\\"Speech\\\":{\\\"LoudR\\\":4,\\\"LoudRE\\\":-15.3,\\\"LoudRS\\\":-19.3,\\\"MaxMomLoud\\\":-9.61,\\\"MaxSTLoud\\\":-14.04,\\\"Loud\\\":-16.88}},\\\"Cutoff\\\":{\\\"FCenL\\\":2028.05,\\\"FCenR\\\":2888.08,\\\"Spkr100G\\\":0,\\\"Spkr150G\\\":0.07,\\\"Spkr200G\\\":0.28},\\\"Loudness\\\":{\\\"Integrated\\\":-16.956}},\\\"Peak\\\":1,\\\"Version\\\":2,\\\"Loudness\\\":-17,\\\"LoudnessRangeEnd\\\":-15.5,\\\"LoudnessRangeStart\\\":-19.7,\\\"LoudnessRange\\\":4.2}\",\"bright_ratio_mean\":\"0.0919\",\"brightness_mean\":\"152.8454\",\"diff_overexposure_ratio\":\"0.0072\",\"flight_id\":\"\",\"loudness\":\"-17\",\"overexposure_ratio_mean\":\"0.0035\",\"peak\":\"1\",\"play_time_prob_dist\":\"[800,0.3795,8401.3177]\",\"sr_score\":\"1.000\",\"std_brightness\":\"12.0401\",\"vq_score\":\"55.86\"}","misc_download_addrs":"{\"suffix_scene\":{\"uri\":\"v12044gd0000d192fcnog65ouluk5f60\",\"url_list\":[\"https://v45.tiktokcdn-eu.com/6c7c8708936435dba8b7b2b12ca777ec/68548d52/video/tos/maliva/tos-maliva-ve-0068c799-us/oMQjUpISHhGffZMKCA8YXqAkg9Qe0xUlHEpQRI/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2304&bt=1152&cs=0&ds=3&ft=XMeJiqqEm3aPD129DKoT3wUuDjGAMeF~O5&mime_type=video_mp4&qs=0&rc=PDQ8MzRkOjc7OzdkNzo6aUBpM2lub3I5cmY1NDMzZzczNEAuX2NeXzMyNjUxNjBeLmEwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=2025061906181346397E96BB7CA53550DC&btag=e00095000\",\"https://v19.tiktokcdn-eu.com/d7bc36ee542b7654e745a871dd71a877/68548d52/video/tos/maliva/tos-maliva-ve-0068c799-us/oMQjUpISHhGffZMKCA8YXqAkg9Qe0xUlHEpQRI/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2304&bt=1152&cs=0&ds=3&ft=XMeJiqqEm3aPD129DKoT3wUuDjGAMeF~O5&mime_type=video_mp4&qs=0&rc=PDQ8MzRkOjc7OzdkNzo6aUBpM2lub3I5cmY1NDMzZzczNEAuX2NeXzMyNjUxNjBeLmEwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=2025061906181346397E96BB7CA53550DC&btag=e00090000\",\"https://api16-normal-no1a.tiktokv.eu/aweme/v1/play/?video_id=v12044gd0000d192fcnog65ouluk5f60&line=0&watermark=1&logo_name=tiktok_end_sonic&source=PUBLISH&file_id=3fd717a43a94488894576ab1a0f9b119&item_id=7517114944362499342&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjFmNTMxOGZiMGZlOWJmYTQyYjUwZTg0OGVmYjQ2MDBj&shp=d05b14bd&shcp=-\"],\"width\":720,\"height\":720,\"data_size\":26207203,\"file_cs\":\"c:0-143697-b9bb\",\"url_prefix\":null}}","need_set_token":false,"origin_cover":{"height":720,"uri":"tos-useast5-p-0068-tx/ooyQIJ3YQXAq5pBAQjeMklUKEeUk9HQk5Hf8CI","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ooyQIJ3YQXAq5pBAQjeMklUKEeUk9HQk5Hf8CI~tplv-dmt-adapt-360p.heic?dr=1360&refresh_token=19df3a47&x-expires=1750370400&x-signature=OQr8OiFdm5ns29aFllaVRuNSYI4%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=feed_cover"],"url_prefix":null,"width":720},"play_addr":{"data_size":23315651,"file_cs":"c:0-143697-b9bb","file_hash":"dc0d3f39653d5d1383f62d1c61ad9d5e","height":1024,"uri":"v12044gd0000d192fcnog65ouluk5f60","url_key":"v12044gd0000d192fcnog65ouluk5f60_h264_540p_1073989","url_list":["https://v45.tiktokcdn-eu.com/c8fc49d58f379d7e3ea4a564a2ddbde2/68548d52/video/tos/maliva/tos-maliva-ve-0068c799-us/o4u9CaIEvIMFiAHihBB4ng4sXQUWSFK1E1PvI/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2096&bt=1048&cs=0&ds=6&ft=XMeJiqqEm3aPD129DKoT3wUuDjGAMeF~O5&mime_type=video_mp4&qs=0&rc=Zmk5aDg8NzxkZTZoZ2QzOkBpM2lub3I5cmY1NDMzZzczNEBfNjY0Yy9jXjMxYF4yYTYwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=2025061906181346397E96BB7CA53550DC&btag=e00095000"],"url_prefix":null,"width":576},"play_addr_bytevc1":{"data_size":13687862,"file_cs":"c:0-144445-e93b","file_hash":"2758eda4b7836458bd1d717a50e4625c","height":1024,"uri":"v12044gd0000d192fcnog65ouluk5f60","url_key":"v12044gd0000d192fcnog65ouluk5f60_bytevc1_540p_630504","url_list":["https://v45.tiktokcdn-eu.com/40a7c7ce8a5412baec20ec1ed1070059/68548d52/video/tos/maliva/tos-maliva-ve-0068c799-us/oIekjEYsQQkaIGHHWCpXd69QIUMgqZAKlA8e2f/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1230&bt=615&cs=2&ds=6&ft=XMeJiqqEm3aPD129DKoT3wUuDjGAMeF~O5&mime_type=video_mp4&qs=11&rc=NDVlZmk0MzY8ZDg3OWU4Z0BpM2lub3I5cmY1NDMzZzczNEAxLmM0Ni5fX14xMl9fNTMxYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=2025061906181346397E96BB7CA53550DC&btag=e00095000"],"url_prefix":null,"width":576},"play_addr_h264":{"data_size":23315651,"file_cs":"c:0-143697-b9bb","file_hash":"dc0d3f39653d5d1383f62d1c61ad9d5e","height":1024,"uri":"v12044gd0000d192fcnog65ouluk5f60","url_key":"v12044gd0000d192fcnog65ouluk5f60_h264_540p_1073989","url_list":["https://v45.tiktokcdn-eu.com/c8fc49d58f379d7e3ea4a564a2ddbde2/68548d52/video/tos/maliva/tos-maliva-ve-0068c799-us/o4u9CaIEvIMFiAHihBB4ng4sXQUWSFK1E1PvI/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2096&bt=1048&cs=0&ds=6&ft=XMeJiqqEm3aPD129DKoT3wUuDjGAMeF~O5&mime_type=video_mp4&qs=0&rc=Zmk5aDg8NzxkZTZoZ2QzOkBpM2lub3I5cmY1NDMzZzczNEBfNjY0Yy9jXjMxYF4yYTYwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=2025061906181346397E96BB7CA53550DC&btag=e00095000"],"url_prefix":null,"width":576},"ratio":"540p","source_HDR_type":0,"tags":null,"vid_profile_labels":"{\"tier3\":\"10059\"}","video_model":"","width":576},"author":{"accept_private_policy":false,"account_labels":null,"account_region":"","ad_cover_url":null,"advance_feature_item_order":null,"advanced_feature_info":null,"apple_account":0,"authority_status":0,"avatar_168x168":{"height":720,"uri":"tos-maliva-avt-0068/7310178711609032710","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&s=PUBLISH&sc=avatar&shcp=132edbea&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_300x300":{"height":720,"uri":"tos-maliva-avt-0068/7310178711609032710","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&idc=no1a&ps=87d6e48a&s=PUBLISH&sc=avatar&shcp=132edbea&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_larger":{"height":720,"uri":"tos-maliva-avt-0068/7310178711609032710","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&s=PUBLISH&sc=avatar&shcp=132edbea&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_medium":{"height":720,"uri":"tos-maliva-avt-0068/7310178711609032710","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&s=PUBLISH&sc=avatar&shcp=132edbea&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_meta_info_list":[{"avatar_category":6,"avatar_meta_info":{}}],"avatar_thumb":{"height":720,"uri":"tos-maliva-avt-0068/7310178711609032710","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606&idc=no1a&ps=87d6e48a&s=PUBLISH&sc=avatar&shcp=132edbea&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_uri":"tos-maliva-avt-0068/7310178711609032710","aweme_count":2135,"bind_phone":"","bold_fields":null,"can_message_follow_status_list":[0],"can_set_geofencing":null,"cha_list":null,"comment_filter_status":0,"comment_setting":0,"commerce_user_level":0,"cover_url":[],"create_time":0,"custom_verify":"Account verificato","cv_level":"","download_prompt_ts":0,"download_setting":0,"duet_setting":0,"enabled_filter_all_comments":false,"enterprise_verify_reason":"","events":null,"fake_data_info":{}},"create_time":1750214725,"is_ad":false,"is_eligible_for_commission":true,"is_paid_partnership":false,"create_time_utc":"2025-09-03T18:37:38.000Z","url":"https://www.tiktok.com/@branttakes/video/7545933721589910798","shop_product_url":"https://www.tiktok.com/shop/pdp/1729494515984797858"}],"max_cursor":1748286476000},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/video":{"post":{"operationId":"social_tiktok_video","x-nexscope-slug":"social-tiktok-video","summary":"TikTok Video Info","description":"Fetches detailed data for a single TikTok video by URL, including its metadata, engagement stats, and optionally its transcript/captions. Returns `aweme_detail` with `desc` (caption), `statistics` (play_count, digg_count/likes, comment_count, share_count, collect_count), `video` URLs, `author` info, and `music` info; also returns `transcript` in WEBVTT format if `get_transcript=true`. For no-watermark video URLs, use `aweme_detail.video.download_no_watermark_addr.url_list[0]` when it exists. If it is missing and `aweme_detail.video.has_watermark` is false, use `aweme_detail.video.play_addr.url_list[0]` instead. If `has_watermark` is true and `download_no_watermark_addr` is missing, TikTok did not return a no-watermark URL for that video. Also accepts photo/slideshow URLs and returns `image_post_info` when available. Availability is source-specific: a TikTok web page can be blocked in your country while this endpoint still retrieves public metadata, and a post can be missing from the profile feed while this endpoint succeeds. A `404 not_found` means the post could not be retrieved through the endpoint's available public sources; it does not by itself prove global deletion. Keep the last known campaign record and retry later with a relevant `region` rather than marking a post deleted from a single failure. [Examples and troubleshooting](https://docs.scrapecreators.com/tiktok-post-availability). Native captions are opt-in via get_transcript=true and are included in the existing base endpoint price. This detail endpoint does not use AI transcription or an AI fallback; missing captions return no transcript. For AI fallback, use /v1/tiktok/video/transcript. Scrapes a public TikTok video or photo/slideshow. Availability can differ from the web page and profile feed; a not-found response alone does not prove deletion. For no-watermark video URLs, use `download_no_watermark_addr` when present, or `play_addr` when `has_watermark` is false. [Availability guide](https://docs.scrapecreators.com/tiktok-post-availability). Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Video Info API View Pricing Get a public TikTok video or slideshow. Availability varies by source; not-found does not prove deletion. For no-watermark URLs, use download_no_watermark_addr, or play_addr only when has_watermark=false. 1 credit per request\nSet to true to download the video/images and get back permanent Supabase URLs. Costs 10 credits if media is found, 1 credit otherwise.\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"TikTok video or photo/slideshow URL"},"region":{"type":"string","description":"Two-letter country code passed to the primary post source. Defaults to US. Try the creator's country if a post is unavailable. This does not guarantee a matching browser/proxy country or complete retrieval; the fallback source does not receive this parameter."},"get_transcript":{"type":"boolean","description":"Native captions are opt-in via get_transcript=true and are included in the existing base endpoint price. This detail endpoint does not use AI transcription or an AI fallback; missing captions return no transcript. For AI fallback, use /v1/tiktok/video/transcript."},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"},"download_media":{"type":"boolean","description":"Set to true to download the video/images and get back permanent Supabase URLs. Costs 10 credits if media is found, 1 credit otherwise."},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.tiktok.com/@randomspamvideos25/video/7251387037834595630"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"aweme_detail":{"aweme_id":"7517114944362499342","desc":"You can say whatever you want about the WNBA is but it’s never boring","desc_language":"en","region":"US","statistics":{"aweme_id":"7517114944362499342","collect_count":1633,"comment_count":618,"digg_count":62522,"download_count":190,"forward_count":0,"lose_comment_count":0,"lose_count":0,"play_count":589745,"repost_count":0,"share_count":3585,"whatsapp_share_count":8},"video":{"CoverTsp":140.193500922967,"ai_dynamic_cover":{"uri":"tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H~tplv-tiktokx-origin.image?dr=9229&refresh_token=1d205fbb&x-expires=1750374000&x-signature=3iaAsuyxWAl52xo73%2FzWWOnRFBo%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=1d1a97fc&idc=no1a&biz_tag=tt_video&s=AWEME_DETAIL&sc=dynamic_cover"],"url_prefix":null},"ai_dynamic_cover_bak":{"uri":"tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H~tplv-tiktokx-origin.image?dr=9229&refresh_token=1d205fbb&x-expires=1750374000&x-signature=3iaAsuyxWAl52xo73%2FzWWOnRFBo%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=1d1a97fc&idc=no1a&biz_tag=tt_video&s=AWEME_DETAIL&sc=dynamic_cover"],"url_prefix":null},"animated_cover":{"uri":"tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H~tplv-tiktokx-origin.image?dr=9229&refresh_token=1d205fbb&x-expires=1750374000&x-signature=3iaAsuyxWAl52xo73%2FzWWOnRFBo%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=1d1a97fc&idc=no1a&biz_tag=tt_video&s=AWEME_DETAIL&sc=dynamic_cover"],"url_prefix":null},"bit_rate":[{"HDR_bit":"","HDR_type":"","bit_rate":694328,"dub_infos":null,"fid_profile_labels":"","fps":30,"gear_name":"adapt_lower_720_2","is_bytevc1":2,"play_addr":{"data_size":15073438,"file_cs":"c:0-144831-d8fd","file_hash":"bade4c49b717e85095bf288836f2cf41","height":1280,"uri":"v12044gd0000d192fcnog65ouluk5f60","url_key":"v12044gd0000d192fcnog65ouluk5f60_bytevc2_720p_694328","url_list":["https://v45.tiktokcdn-eu.com/181058a705ab5b81ac71c7ec81b7d91c/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/oQOIKCXpeQMxlHgA9YwA8fQqQkIfj3UHkctEaC/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1356&bt=678&cs=5&ds=3&ft=pfEtGMvt8Zmo0Ym-qI4jVVPF461rKsd.&mime_type=video_mp4&qs=14&rc=ZWQ3OTk1ODMzZGU0NjY3aUBpM2lub3I5cmY1NDMzZzczNEAuNS8yMl4tX18xNmAuYzUwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=202506182326187F8DDAF6E643528715CE&btag=e00095000"],"url_prefix":null,"width":720},"quality_type":14,"video_extra":"{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 264024}, {\\\"time\\\": 2, \\\"offset\\\": 330253}, {\\\"time\\\": 3, \\\"offset\\\": 403843}, {\\\"time\\\": 4, \\\"offset\\\": 488694}, {\\\"time\\\": 5, \\\"offset\\\": 579736}, {\\\"time\\\": 10, \\\"offset\\\": 996199}]\",\"mvmaf\":\"{\\\"v2.0\\\": {\\\"srv1\\\": {\\\"v1080\\\": 96.728, \\\"v960\\\": 97.931, \\\"v864\\\": 98.683, \\\"v720\\\": 99.11}, \\\"ori\\\": {\\\"v1080\\\": 89.806, \\\"v960\\\": 91.917, \\\"v864\\\": 92.924, \\\"v720\\\": 95.104}}}\",\"ufq\":\"{\\\"enh\\\":66.187,\\\"playback\\\":{\\\"ori\\\":59.993,\\\"srv1\\\":64.978},\\\"src\\\":66.187,\\\"trans\\\":59.993,\\\"version\\\":\\\"v1.2\\\"}\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"398b00a3a79e904ef5421940da02ff2a\",\"dec_info\":\"\",\"gearvqm\":\"\"}"}],"bit_rate_audio":[],"cdn_url_expired":0,"cover":{"height":720,"uri":"tos-useast5-p-0068-tx/oUKFS4HhaMvXICUEIc1AgN7HEs9nivBIBC4iI","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oUKFS4HhaMvXICUEIc1AgN7HEs9nivBIBC4iI~tplv-tiktokx-cropcenter-q:300:400:q72.heic?dr=9232&refresh_token=df2ee5c4&x-expires=1750374000&x-signature=F1wskCOFUKVbHMDT%2BjC%2F4ioi3Vw%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=1d1a97fc&idc=no1a&sc=cover&biz_tag=tt_video&s=AWEME_DETAIL"],"url_prefix":null,"width":720},"cover_is_custom":true,"did_profile_labels":"","download_addr":{"data_size":24637995,"file_cs":"c:0-143697-b9bb","height":720,"uri":"v12044gd0000d192fcnog65ouluk5f60","url_list":["https://v45.tiktokcdn-eu.com/3d049ec218f82d1ad3e7e9ee12cccb39/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/osMffQHg9IKplXhIekq8xUpGsKuYCjAqSQQEAH/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2216&bt=1108&cs=0&ds=3&ft=pfEtGMvt8Zmo0Ym-qI4jVVPF461rKsd.&mime_type=video_mp4&qs=0&rc=NDxmZGg1ZTw6NGlkNDM1N0BpM2lub3I5cmY1NDMzZzczNEAuMGEwMGBfXmExMWA2Y2I2YSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=202506182326187F8DDAF6E643528715CE&btag=e00095000"],"url_prefix":null,"width":720},"download_no_watermark_addr":{"data_size":23315651,"file_cs":"c:0-143697-b9bb","file_hash":"dc0d3f39653d5d1383f62d1c61ad9d5e","height":1024,"uri":"v12044gd0000d192fcnog65ouluk5f60","url_key":"v12044gd0000d192fcnog65ouluk5f60_h264_540p_1073989","url_list":["https://v45.tiktokcdn-eu.com/c0fb0c4c63ed4f5076758092137da3f5/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/o4u9CaIEvIMFiAHihBB4ng4sXQUWSFK1E1PvI/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2096&bt=1048&cs=0&ds=6&ft=pfEtGMvt8Zmo0Ym-qI4jVVPF461rKsd.&mime_type=video_mp4&qs=0&rc=Zmk5aDg8NzxkZTZoZ2QzOkBpM2lub3I5cmY1NDMzZzczNEBfNjY0Yy9jXjMxYF4yYTYwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=202506182326187F8DDAF6E643528715CE&btag=e00095000"],"url_prefix":null,"width":576},"duration":173675,"dynamic_cover":{"height":720,"uri":"tos-useast5-p-0068-tx/oIQCgk8IAMQfKA2ewUdC8XIH9HktlgfqjEpU2F","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oIQCgk8IAMQfKA2ewUdC8XIH9HktlgfqjEpU2F~tplv-tiktokx-origin.image?dr=9229&refresh_token=949e4dcb&x-expires=1750374000&x-signature=nMjefiiuLg8GZ9QABQL3YDVaKHo%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=1d1a97fc&idc=no1a&biz_tag=tt_video&s=AWEME_DETAIL&sc=dynamic_cover"],"url_prefix":null,"width":720},"has_watermark":true,"height":1024,"is_bytevc1":0,"is_callback":true,"is_long_video":1,"meta":"{\"LoudnessRange\":\"4.2\",\"LoudnessRangeEnd\":\"-15.5\",\"LoudnessRangeStart\":\"-19.7\",\"MaximumMomentaryLoudness\":\"-9.6\",\"MaximumShortTermLoudness\":\"-14\",\"Version\":\"2\",\"VolumeInfoJson\":\"{\\\"LoudnessRangeStart\\\":-19.7,\\\"MaximumShortTermLoudness\\\":-14,\\\"Peak\\\":1,\\\"Metrics\\\":{\\\"AEDInfo\\\":{\\\"MusicRatio\\\":0,\\\"SingingRatio\\\":0.1,\\\"SpeechRatio\\\":0.89},\\\"AnchorLoudness\\\":{\\\"Speech\\\":{\\\"MaxMomLoud\\\":-9.61,\\\"MaxSTLoud\\\":-14.04,\\\"Loud\\\":-16.88,\\\"LoudR\\\":4,\\\"LoudRE\\\":-15.3,\\\"LoudRS\\\":-19.3}},\\\"Cutoff\\\":{\\\"FCenL\\\":2028.05,\\\"FCenR\\\":2888.08,\\\"Spkr100G\\\":0,\\\"Spkr150G\\\":0.07,\\\"Spkr200G\\\":0.28},\\\"Loudness\\\":{\\\"Integrated\\\":-16.956},\\\"Phase\\\":{\\\"RMSDownmixDiff\\\":-0.635},\\\"RMSStats\\\":{\\\"Peak\\\":0.099,\\\"RTotal\\\":-25.112,\\\"LRDiff\\\":6.91,\\\"LTotal\\\":-18.202},\\\"Version\\\":\\\"1.4.2\\\"},\\\"Version\\\":2,\\\"Loudness\\\":-17,\\\"LoudnessRange\\\":4.2,\\\"LoudnessRangeEnd\\\":-15.5,\\\"MaximumMomentaryLoudness\\\":-9.6}\",\"bright_ratio_mean\":\"0.0919\",\"brightness_mean\":\"152.8454\",\"diff_overexposure_ratio\":\"0.0072\",\"flight_id\":\"\",\"loudness\":\"-17\",\"overexposure_ratio_mean\":\"0.0035\",\"peak\":\"1\",\"play_time_prob_dist\":\"[800,0.3795,8401.3177]\",\"sr_score\":\"1.000\",\"std_brightness\":\"12.0401\",\"vq_score\":\"55.86\"}","misc_download_addrs":"{\"suffix_scene\":{\"uri\":\"v12044gd0000d192fcnog65ouluk5f60\",\"url_list\":[\"https://v45.tiktokcdn-eu.com/eb4b1ebe709b6ec8bb4b8e40c7c1d919/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/oMQjUpISHhGffZMKCA8YXqAkg9Qe0xUlHEpQRI/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2304&bt=1152&cs=0&ds=3&ft=pfEtGMvt8Zmo0Ym-qI4jVVPF461rKsd.&mime_type=video_mp4&qs=0&rc=PDQ8MzRkOjc7OzdkNzo6aUBpM2lub3I5cmY1NDMzZzczNEAuX2NeXzMyNjUxNjBeLmEwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=202506182326187F8DDAF6E643528715CE&btag=e00095000\",\"https://v16m.tiktokcdn-eu.com/cf3dc5bd920320de7fccd7a67e8ff0df/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/oMQjUpISHhGffZMKCA8YXqAkg9Qe0xUlHEpQRI/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2304&bt=1152&cs=0&ds=3&ft=pfEtGMvt8Zmo0Ym-qI4jVVPF461rKsd.&mime_type=video_mp4&qs=0&rc=PDQ8MzRkOjc7OzdkNzo6aUBpM2lub3I5cmY1NDMzZzczNEAuX2NeXzMyNjUxNjBeLmEwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=202506182326187F8DDAF6E643528715CE&btag=e00090000\",\"https://api16-normal-no1a.tiktokv.eu/aweme/v1/play/?video_id=v12044gd0000d192fcnog65ouluk5f60&line=0&watermark=1&logo_name=tiktok_end_sonic&source=AWEME_DETAIL&file_id=3fd717a43a94488894576ab1a0f9b119&item_id=7517114944362499342&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjFmNTMxOGZiMGZlOWJmYTQyYjUwZTg0OGVmYjQ2MDBj&shp=d05b14bd&shcp=-\"],\"width\":720,\"height\":720,\"data_size\":26207203,\"file_cs\":\"c:0-143697-b9bb\",\"url_prefix\":null}}","need_set_token":false,"origin_cover":{"height":720,"uri":"tos-useast5-p-0068-tx/ooyQIJ3YQXAq5pBAQjeMklUKEeUk9HQk5Hf8CI","url_list":["https://p19-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ooyQIJ3YQXAq5pBAQjeMklUKEeUk9HQk5Hf8CI~tplv-dmt-adapt-360p.heic?dr=1360&refresh_token=4649c5e4&x-expires=1750374000&x-signature=NcVGrk0KTmDoN6EaPa%2Fn05CEyq4%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=1d1a97fc&idc=no1a&s=AWEME_DETAIL&sc=feed_cover&biz_tag=tt_video"],"url_prefix":null,"width":720},"play_addr":{"data_size":23315651,"file_cs":"c:0-143697-b9bb","file_hash":"dc0d3f39653d5d1383f62d1c61ad9d5e","height":1024,"uri":"v12044gd0000d192fcnog65ouluk5f60","url_key":"v12044gd0000d192fcnog65ouluk5f60_h264_540p_1073989","url_list":["https://v45.tiktokcdn-eu.com/c0fb0c4c63ed4f5076758092137da3f5/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/o4u9CaIEvIMFiAHihBB4ng4sXQUWSFK1E1PvI/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2096&bt=1048&cs=0&ds=6&ft=pfEtGMvt8Zmo0Ym-qI4jVVPF461rKsd.&mime_type=video_mp4&qs=0&rc=Zmk5aDg8NzxkZTZoZ2QzOkBpM2lub3I5cmY1NDMzZzczNEBfNjY0Yy9jXjMxYF4yYTYwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=202506182326187F8DDAF6E643528715CE&btag=e00095000"],"url_prefix":null,"width":576},"play_addr_bytevc1":{"data_size":13687862,"file_cs":"c:0-144445-e93b","file_hash":"2758eda4b7836458bd1d717a50e4625c","height":1024,"uri":"v12044gd0000d192fcnog65ouluk5f60","url_key":"v12044gd0000d192fcnog65ouluk5f60_bytevc1_540p_630504","url_list":["https://v45.tiktokcdn-eu.com/6f7ee0f58f0c58d39943fdbb31ca96b5/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/oIekjEYsQQkaIGHHWCpXd69QIUMgqZAKlA8e2f/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1230&bt=615&cs=2&ds=6&ft=pfEtGMvt8Zmo0Ym-qI4jVVPF461rKsd.&mime_type=video_mp4&qs=11&rc=NDVlZmk0MzY8ZDg3OWU4Z0BpM2lub3I5cmY1NDMzZzczNEAxLmM0Ni5fX14xMl9fNTMxYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=202506182326187F8DDAF6E643528715CE&btag=e00095000"],"url_prefix":null,"width":576},"play_addr_h264":{"data_size":23315651,"file_cs":"c:0-143697-b9bb","file_hash":"dc0d3f39653d5d1383f62d1c61ad9d5e","height":1024,"uri":"v12044gd0000d192fcnog65ouluk5f60","url_key":"v12044gd0000d192fcnog65ouluk5f60_h264_540p_1073989","url_list":["https://v45.tiktokcdn-eu.com/c0fb0c4c63ed4f5076758092137da3f5/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/o4u9CaIEvIMFiAHihBB4ng4sXQUWSFK1E1PvI/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2096&bt=1048&cs=0&ds=6&ft=pfEtGMvt8Zmo0Ym-qI4jVVPF461rKsd.&mime_type=video_mp4&qs=0&rc=Zmk5aDg8NzxkZTZoZ2QzOkBpM2lub3I5cmY1NDMzZzczNEBfNjY0Yy9jXjMxYF4yYTYwYSMzMnJyMmRrYzZhLS1kMS9zcw%3D%3D&vvpl=1&l=202506182326187F8DDAF6E643528715CE&btag=e00095000"],"url_prefix":null,"width":576},"ratio":"540p","source_HDR_type":0,"tags":null,"vid_profile_labels":"{\"tier3\":\"10059\"}","video_model":"","width":576},"author":{"accept_private_policy":false,"account_labels":null,"account_region":"","ad_cover_url":null,"advance_feature_item_order":null,"advanced_feature_info":null,"apple_account":0,"authority_status":0,"avatar_168x168":{"height":720,"uri":"tos-maliva-avt-0068/7310178711609032710","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&s=AWEME_DETAIL&sc=avatar&shcp=1d1a97fc&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_larger":{"height":720,"uri":"tos-maliva-avt-0068/7310178711609032710","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&s=AWEME_DETAIL&sc=avatar&shcp=1d1a97fc&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_thumb":{"height":720,"uri":"tos-maliva-avt-0068/7310178711609032710","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606&idc=no1a&ps=87d6e48a&s=AWEME_DETAIL&sc=avatar&shcp=1d1a97fc&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_uri":"tos-maliva-avt-0068/7310178711609032710","aweme_count":0,"bind_phone":"","bold_fields":null,"can_message_follow_status_list":[0],"can_set_geofencing":null,"cha_list":null,"comment_filter_status":0,"comment_setting":0,"commerce_user_level":0,"cover_url":[],"create_time":0,"custom_verify":"Account verificato","cv_level":"","download_prompt_ts":0,"download_setting":0,"duet_setting":0,"enabled_filter_all_comments":false,"enterprise_verify_reason":"","events":null,"fake_data_info":{},"favoriting_count":0,"fb_expire_time":0,"follow_status":0},"create_time":1750214725,"is_ad":false,"is_eligible_for_commission":true,"is_paid_partnership":false,"create_time_utc":"2025-09-03T18:37:38.000Z","url":"https://www.tiktok.com/@branttakes/video/7545933721589910798","shop_product_url":"https://www.tiktok.com/shop/pdp/1729494515984797858"},"transcript":"WEBVTT\n\n\n00:00:00.340 --> 00:00:01.860\nAll right. W N B A. Rant.\n\n00:00:01.861 --> 00:00:02.741\nI know. It's like,\n\n00:00:02.742 --> 00:00:03.261\noh, Dave,\n\n00:00:03.262 --> 00:00:04.941\nwe don't wanna hear about you in the W N B A.\n\n00:00:04.942 --> 00:00:06.781\nI'm sorry. I fucking love it,"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/video/transcript":{"post":{"operationId":"social_tiktok_video_transcript","x-nexscope-slug":"social-tiktok-video-transcript","summary":"TikTok Transcript","description":"Extracts existing transcripts, captions, or subtitles from a TikTok video by URL. Returns id, url, and transcript (native captions are WEBVTT-formatted; AI fallback returns text). Also includes top-level transcript_with_timestamp: an array of {start: number, end: number, text: string} sentence/phrase segments from native captions or AI, or null when speech or timing is unavailable. Times are seconds relative to the video. AI timings are approximate, not word-perfect. The existing transcript remains the exact raw WEBVTT string for native captions and a plain string for AI fallback. No new parameter is required, and pricing is unchanged. Native transcripts cost 1 credit only when returned, with no fixed length limit; no transcript costs 0 credits. AI fallback is opt-in via use_ai_as_fallback=true and is used only when native captions are unavailable. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This dedicated transcript route charges the AI rate instead of adding a native-caption fee. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed. Get native captions or an opted-in AI transcript from a TikTok video. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Transcript API View Pricing Get native captions or an opt-in AI transcript with timestamp segments from a TikTok video. Long AI transcripts may time out. Native captions or AI up to 2 minutes: 1 credit. Paid AI mode: 10 credits/minute, rounded up, even for short videos. No transcript: 0 credits.\nExtracts existing transcripts, captions, or subtitles from a TikTok video by URL. Returns id, url, and transcript (native captions are WEBVTT-formatted; AI fallback returns text). Also includes top-level transcript_with_timestamp: an array of {start: number, end: number, text: string} sentence/phrase segments from native captions or AI, or null when speech or timing is unavailable. Times are seconds relative to the video. AI timings are approximate, not word-perfect. The existing transcript remains the exact raw WEBVTT string for native captions and a plain string for AI fallback. No new parameter is required, and pricing is unchanged. Native transcripts cost 1 credit only when returned, with no fixed length limit; no transcript costs 0 credits. AI fallback is opt-in via use_ai_as_fallback=true and is used only when native captions are unavailable. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This dedicated transcript route charges the AI rate instead of adding a native-caption fee. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed. Get native captions or an opted-in AI transcript from a TikTok video. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nPaid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nSet to 'true' to use paid AI only when existing captions are unavailable. Defaults to false. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nNative or default successful AI <=120s: 1; no transcript 0. Long AI mode must be explicitly enabled in addition to transcription; all successful AI, including short, costs 10 per started minute. See parameters for flags.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"TikTok video URL"},"language":{"type":"string","description":"Language of the transcript. 2 letter language code, ie 'en', 'es', 'fr', 'de', 'it', 'ja', 'ko', 'zh'"},"allow_long_transcription":{"type":"boolean","default":false,"description":"Paid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed."},"use_ai_as_fallback":{"type":"string","description":"Set to 'true' to use paid AI only when existing captions are unavailable. Defaults to false. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.tiktok.com/@stoolpresidente/video/7499229683859426602"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"id":"7499229683859426602","url":"https://www.tiktok.com/@stoolpresidente/video/7499229683859426602","transcript_with_timestamp":null,"transcript":"WEBVTT\n\n\n00:00:00.120 --> 00:00:01.840\nAlright, pizza review time.\n\n00:00:01.841 --> 00:00:03.761\nSal's Pizza Factory. Oh,\n\n00:00:03.762 --> 00:00:05.721\nit's Fucking Corn. We're in Charlotte.\n\n00:00:05.722 --> 00:00:07.861\nAlright man, any chance I can get a real quick picture?\n\n00:00:07.920 --> 00:00:10.040\nShaq or Dwight Howard? I gotta pick one.\\n"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/user/live":{"post":{"operationId":"social_tiktok_user_live","x-nexscope-slug":"social-tiktok-user-live","summary":"TikTok Live","description":"Checks a TikTok user's live status and retrieves available live room details. First checks the account with the same profile lookup used by /v1/tiktok/profile; this does not add a second API credit charge. Active streams return HTTP 200 with is_live: true; an existing account that is offline or has no current stream returns HTTP 200 with is_live: false. Both successful states cost 1 credit, including offline/no-stream accounts. Unavailable accounts: HTTP 404 when TikTok confirms the account is not found or unavailable. Audience controls: HTTP 403 when TikTok confirms the creator enabled them, with TikTok's login warning. Retrieval failures: HTTP 500 when the live check fails. Errors cost 0 credits (credits_charged: 0); never infer offline from an error. A failed check is not evidence that the account is offline, and having no current stream is not an account-not-found error. Use the top-level `is_live` boolean instead of checking TikTok's numeric status values yourself. Available details include `liveRoomUserInfo` (nickname, avatar, followerCount, roomId) and `liveRoom` (title, startTime, status, `liveRoomStats` with enterCount and userCount, plus `streamData` with playback URLs in multiple qualities). When no room exists, `liveRoom` is omitted rather than filled with invented room data. Ended-room details remain when TikTok supplies them. A real viewer count of zero is not treated as a restriction. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Live API View Pricing Checks TikTok live status and room details. 200 is_live:true/false costs 1 credit, including offline/no-stream accounts. Unavailable accounts: 404; audience controls: 403; retrieval failures: 500. Errors cost 0 credits; never infer offline. 1 credit per request\nChecks a TikTok user's live status and retrieves available live room details. First checks the account with the same profile lookup used by /v1/tiktok/profile; this does not add a second API credit charge. Active streams return HTTP 200 with is_live: true; an existing account that is offline or has no current stream returns HTTP 200 with is_live: false. Both successful states cost 1 credit, including offline/no-stream accounts. Unavailable accounts: HTTP 404 when TikTok confirms the account is not found or unavailable. Audience controls: HTTP 403 when TikTok confirms the creator enabled them, with TikTok's login warning. Retrieval failures: HTTP 500 when the live check fails. Errors cost 0 credits (credits_charged: 0); never infer offline from an error. A failed check is not evidence that the account is offline, and having no current stream is not an account-not-found error. Use the top-level `is_live` boolean instead of checking TikTok's numeric status values yourself. Available details include `liveRoomUserInfo` (nickname, avatar, followerCount, roomId) and `liveRoom` (title, startTime, status, `liveRoomStats` with enterCount and userCount, plus `streamData` with playback URLs in multiple qualities). When no room exists, `liveRoom` is omitted rather than filled with invented room data. Ended-room details remain when TikTok supplies them. A real viewer count of zero is not treated as a restriction.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"TikTok handle"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"thejustalex"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"is_live":true,"liveRoomUserInfo":{"avatarLarger":"https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/b169e9223700dc8d20d327510eb47f94~tplv-tiktokx-cropcenter:1080:1080.webp?dr=9640&refresh_token=c39a7259&x-expires=1751918400&x-signature=2Q%2F13wVO%2F%2F5OFBDinwMuULyBINc%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=useast5","avatarMedium":"https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/b169e9223700dc8d20d327510eb47f94~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=7da1901a&x-expires=1751918400&x-signature=WDVM4wsOBsWKV04aQNYqBRnllxQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=useast5","avatarThumb":"https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/b169e9223700dc8d20d327510eb47f94~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=baf34a19&x-expires=1751918400&x-signature=fWClWNGmv23Nggnk7gE17yC3D78%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=5be10d83&idc=useast5","id":"6742945285876515845","nickname":"JustAlex","secUid":"MS4wLjABAAAA3_8rhYkKsHyYO45EzOF7RBQJRs1EaHBqHFtYIaz3aka44bMVgCLONvFaXPkddJei","uniqueId":"thejustalex","verified":false,"roomId":"7523685855395842871","signature":"\uD83D\uDD34LIVE EVERYDAY\uD83D\uDD34\n—\n\uD83D\uDCE7rainzbizemail@gmail.com\uD83D\uDCE7\nSocials \uD83D\uDC47","status":2,"followStatus":0,"followingCount":1225,"followerCount":601562},"liveRoom":{"coverUrl":"https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/b169e9223700dc8d20d327510eb47f94~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=524467bc&x-expires=1751918400&x-signature=dYrBW7UodqMDScfs4YMnmfK24Zg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=useast5","squareCoverImg":"https://p16-webcast.tiktokcdn-us.com/webcast-oci-tx/98159d71f96ce0a13c8234c485082e14~tplv-obj.image","title":"6'13 Grateful Streamer","startTime":1751744708,"status":2,"paidEvent":{"event_id":0,"paid_type":0},"liveSubOnly":0,"liveRoomMode":6,"hashTagId":5,"gameTagId":1983,"liveRoomStats":{"enterCount":30960,"userCount":804},"streamData":{"pull_data":{"options":{"default_quality":{"icon_type":0,"level":0,"name":"540p","resolution":"","sdk_key":"sd","v_codec":""},"qualities":[{"icon_type":6,"level":10,"name":"Original","resolution":"","sdk_key":"origin","v_codec":""}],"show_quality_button":false},"stream_data":"{\"common\":{\"session_id\":\"173-20250705204222D51B254BA2C5D264202E\",\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"ids\\\\\\\":[\\\\\\\"ex_83506(Weight:100)\\\\\\\"],\\\\\\\"result\\\\\\\":{\\\\\\\"hit\\\\\\\":\\\\\\\"exclusive\\\\\\\",\\\\\\\"cdn\\\\\\\":2137}}\\\"}\",\"user_count\":798,\"peer_anchor_level\":39},\"data\":{\"hd\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd.flv?expire=1752957742&sign=0b9f362ee81ab0494d8a2a7a79151d1b\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd/index.m3u8?expire=1752957742&sign=b8c9cd9d85166f52d3beeda633ffc4dc\",\"cmaf\":\"https://pull-cmaf-f30-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd/index.mpd?expire=1752957742&sign=f3419a82237b7a24ebe2c8b04a269bed\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd.sdp?expire=1752957742&sign=611544c2e091d9412c4703535d062cf8\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"v_rtbitrate_std\\\":72940,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"gop\\\":4,\\\"VCodec\\\":\\\"h264\\\",\\\"vbitrate\\\":1800000,\\\"resolution\\\":\\\"720x1280\\\",\\\"v_rtbitrate_timestamp\\\":1751748120688,\\\"v_rtbitrate_vpaas_timestamp\\\":1751748140793,\\\"v_rtpsnr\\\":0,\\\"v_rtbitrate\\\":1805570,\\\"v_rtbitrate_pct\\\":1869670,\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"stream_suffix\\\":\\\"hd\\\"}\"}},\"sd\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_sd.flv?expire=1752957742&sign=a997e60f7b2943569d2150b235189f61\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_sd/index.m3u8?expire=1752957742&sign=e11b60cc01d20d8249ed3ac794451f18\",\"cmaf\":\"https://pull-cmaf-f30-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_sd/index.mpd?expire=1752957742&sign=5ea0fad39792b612278240cee4e004f8\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_sd.sdp?expire=1752957742&sign=897230cfaaaa5c0f466f356d0da03fa5\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"v_rtbitrate_std\\\":43610,\\\"v_rtbitrate_timestamp\\\":1751748139604,\\\"v_rtbitrate_vpaas_timestamp\\\":1751748140793,\\\"resolution\\\":\\\"540x960\\\",\\\"VCodec\\\":\\\"h264\\\",\\\"cdn_name\\\":\\\"fcdn\\\",\\\"v_rtpsnr\\\":0,\\\"v_rtbitrate_pct\\\":1256440,\\\"gop\\\":4,\\\"stream_suffix\\\":\\\"sd\\\",\\\"vbitrate\\\":1200000,\\\"v_rtbitrate\\\":1208280}\"}},\"ld\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_ld.flv?expire=1752957742&sign=38fd63476fc1b0c3b7fc6828ffaa8ee2\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_ld/index.m3u8?expire=1752957742&sign=cb052bc15dddf7bb6305b2583a03bac7\",\"cmaf\":\"https://pull-cmaf-f30-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_ld/index.mpd?expire=1752957742&sign=fbd383e74714925a0abb2582fbe1a880\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_ld.sdp?expire=1752957742&sign=6312c2f07b9d50722464d60d39c5f7be\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"ld\\\",\\\"v_rtpsnr\\\":0,\\\"vbitrate\\\":600000,\\\"v_rtbitrate_vpaas_timestamp\\\":1751748140793,\\\"v_rtbitrate_pct\\\":621460,\\\"v_rtbitrate\\\":594320,\\\"VCodec\\\":\\\"h264\\\",\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"resolution\\\":\\\"360x640\\\",\\\"gop\\\":4,\\\"v_rtbitrate_timestamp\\\":1751748132947,\\\"v_rtbitrate_std\\\":32580}\"}},\"origin\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_or4.flv?expire=1752957742&sign=cca075017a40a1573e92cac5522b5569\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_or4/index.m3u8?expire=1752957742&sign=e1d5e30eeeff14c0d24f2cd6caaa673e\",\"cmaf\":\"https://pull-cmaf-f30-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_or4/index.mpd?expire=1752957742&sign=955dbce31988959e0c69eb4562d96cf5\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_or4.sdp?expire=1752957742&sign=b3dd11ab0bdb4d90831e4f2a12bf3668\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"v_rtbitrate_std\\\":731110,\\\"resolution\\\":\\\"1080x1920\\\",\\\"v_rtbitrate_vpaas_timestamp\\\":1751748140793,\\\"v_rtbitrate\\\":7974420,\\\"stream_suffix\\\":\\\"or4\\\",\\\"cdn_name\\\":\\\"fcdn\\\",\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"gop\\\":4,\\\"v_rtpsnr\\\":0,\\\"v_rtbitrate_pct\\\":8378510,\\\"vbitrate\\\":1000000,\\\"v_rtbitrate_timestamp\\\":1751747896985}\"}},\"uhd_60\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_uhd60.flv?expire=1752957742&sign=248ade261c9487bfa809d173ac4d6971\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_uhd60/index.m3u8?expire=1752957742&sign=f5429c98a33a69391b66d31e507e5630\",\"cmaf\":\"https://pull-cmaf-f30-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_uhd60/index.mpd?expire=1752957742&sign=533ecdc8e82a9c7982bc24276aab6381\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_uhd60.sdp?expire=1752957742&sign=7d56655e54107ed5c1eaed85f82f6bad\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"stream_suffix\\\":\\\"uhd60\\\",\\\"resolution\\\":\\\"1080x1920\\\",\\\"v_rtbitrate_vpaas_timestamp\\\":1751748140793,\\\"Auto\\\":{\\\"Demotion\\\":{\\\"StallCount\\\":4},\\\"Enable\\\":1},\\\"VCodec\\\":\\\"h264\\\",\\\"vbitrate\\\":5000000,\\\"v_rtbitrate_pct\\\":5198550,\\\"v_rtbitrate\\\":5013970,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"v_rtpsnr\\\":0,\\\"v_rtbitrate_timestamp\\\":1751748132146,\\\"v_rtbitrate_std\\\":135130,\\\"gop\\\":4}\"}},\"hd_60\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd60.flv?expire=1752957742&sign=283876364b4bb8a81c841d1f54294a08\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd60/index.m3u8?expire=1752957742&sign=fa51b72baac3cb6a5fb141ca16c78a2d\",\"cmaf\":\"https://pull-cmaf-f30-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd60/index.mpd?expire=1752957742&sign=91d31328a64fe80eb41436a3f0570572\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd60.sdp?expire=1752957742&sign=c7a001d036db84460189a158215560f9\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"stream_suffix\\\":\\\"hd60\\\",\\\"v_rtbitrate_timestamp\\\":1751747845776,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"v_rtbitrate\\\":3008490,\\\"v_rtbitrate_std\\\":42360,\\\"gop\\\":4,\\\"v_rtpsnr\\\":0,\\\"VCodec\\\":\\\"h264\\\",\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"v_rtbitrate_vpaas_timestamp\\\":1751748140793,\\\"vbitrate\\\":3000000,\\\"v_rtbitrate_pct\\\":3074100,\\\"resolution\\\":\\\"720x1280\\\"}\"}},\"ao\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836.flv?expire=1752957742&sign=e3deaa3e74cc33921accfe3e6165c407&only_audio=1\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"resolution\\\":\\\"\\\",\\\"VCodec\\\":\\\"h264\\\",\\\"Auto\\\":{\\\"Demotion\\\":{\\\"StallCount\\\":4},\\\"Enable\\\":1},\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"vbitrate\\\":0}\"}}}}"}},"streamId":"3576322110592123836","multiStreamScene":0,"multiStreamSource":0,"hevcStreamData":{"pull_data":{"options":{"default_quality":{"icon_type":0,"level":0,"name":"540p","resolution":"","sdk_key":"sd","v_codec":""},"qualities":[{"icon_type":6,"level":10,"name":"Original","resolution":"","sdk_key":"origin","v_codec":""}],"show_quality_button":false},"stream_data":"{\"common\":{\"session_id\":\"173-20250705204222D51B254BA2C5D264202E\",\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"ids\\\\\\\":[\\\\\\\"ex_83506(Weight:100)\\\\\\\"],\\\\\\\"result\\\\\\\":{\\\\\\\"hit\\\\\\\":\\\\\\\"exclusive\\\\\\\",\\\\\\\"cdn\\\\\\\":2137}}\\\"}\",\"user_count\":811,\"peer_anchor_level\":39},\"data\":{\"origin\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836.flv?expire=1752957742&sign=e3deaa3e74cc33921accfe3e6165c407\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/game/stream-3576322110592123836/index.m3u8?expire=1752957742&sign=dabd5577a80d25e975119ad5de32d7c4\",\"cmaf\":\"https://pull-cmaf-f30-tt01.tiktokcdn-us.com/game/stream-3576322110592123836/index.mpd?expire=1752957742&sign=1cc6612292638ca67524aea9a43a7832\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836.sdp?expire=1752957742&sign=d9bafd32a98bb13e9af529e7ecaf6006\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"VCodec\\\":\\\"h265\\\",\\\"vbitrate\\\":9281000,\\\"resolution\\\":\\\"1080x1920\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\"}\"}},\"hd\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd5.flv?expire=1752957742&sign=6c568f1678af9da83ed34e5823f9305e\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd5/index.m3u8?expire=1752957742&sign=2bad9c9a97c350298d43aaca1fe81908\",\"cmaf\":\"https://pull-cmaf-f30-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd5/index.mpd?expire=1752957742&sign=ab1f937626b58046160280f9a742d4bc\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd5.sdp?expire=1752957742&sign=cd292d10f45021af548246623adc1087\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"stream_suffix\\\":\\\"hd5\\\",\\\"resolution\\\":\\\"720x1280\\\",\\\"v_rtbitrate_pct\\\":1536060,\\\"VCodec\\\":\\\"h265\\\",\\\"cdn_name\\\":\\\"fcdn\\\",\\\"v_rtbitrate\\\":1471180,\\\"v_rtbitrate_timestamp\\\":1751748131506,\\\"v_rtbitrate_vpaas_timestamp\\\":1751748139608,\\\"v_rtbitrate_std\\\":83830,\\\"vbitrate\\\":1600000,\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"gop\\\":4,\\\"v_rtpsnr\\\":0}\"}},\"sd\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_sd5.flv?expire=1752957742&sign=ef65e623965fb0c06aae09d13fad00d6\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_sd5/index.m3u8?expire=1752957742&sign=053370002175f4c4d5917305356690eb\",\"cmaf\":\"https://pull-cmaf-f30-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_sd5/index.mpd?expire=1752957742&sign=160c7efddb13960c75775f1ffedff113\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_sd5.sdp?expire=1752957742&sign=58b676988631de614b26ba978072a035\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"gop\\\":4,\\\"vbitrate\\\":1000000,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"v_rtbitrate\\\":1137520,\\\"resolution\\\":\\\"540x960\\\",\\\"v_rtpsnr\\\":0,\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"v_rtbitrate_vpaas_timestamp\\\":1751748139608,\\\"v_rtbitrate_std\\\":29840,\\\"v_rtbitrate_timestamp\\\":1751748134917,\\\"v_rtbitrate_pct\\\":1169410,\\\"stream_suffix\\\":\\\"sd5\\\"}\"}},\"ld\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_ld5.flv?expire=1752957742&sign=7abfe33020aed52d7e9c6b0b5c2d9843\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_ld5/index.m3u8?expire=1752957742&sign=0f660361551ef159118d92b7b7f590a8\",\"cmaf\":\"https://pull-cmaf-f30-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_ld5/index.mpd?expire=1752957742&sign=f847714e33c6a2ec2743e4e5ff8346cb\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_ld5.sdp?expire=1752957742&sign=ddd1eda19aae900d4d4518f931c88b0c\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"v_rtbitrate_pct\\\":584770,\\\"VCodec\\\":\\\"h265\\\",\\\"v_rtbitrate_timestamp\\\":1751748120961,\\\"v_rtbitrate\\\":553930,\\\"v_rtbitrate_vpaas_timestamp\\\":1751748139608,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"vbitrate\\\":600000,\\\"v_rtpsnr\\\":0,\\\"resolution\\\":\\\"360x640\\\",\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"v_rtbitrate_std\\\":37620,\\\"stream_suffix\\\":\\\"ld5\\\",\\\"gop\\\":4}\"}},\"uhd_60\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_uhd560.flv?expire=1752957742&sign=b99f69ff5e7685362398fa7965787402\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_uhd560/index.m3u8?expire=1752957742&sign=1c0bd75d36c5b78c93a2c2ffc1f469cb\",\"cmaf\":\"https://pull-cmaf-f30-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_uhd560/index.mpd?expire=1752957742&sign=93757d64ec94128815996c932b58d874\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_uhd560.sdp?expire=1752957742&sign=28b90e7294f7819a1961d1cae41ab50a\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"Auto\\\":{\\\"Demotion\\\":{\\\"StallCount\\\":4},\\\"Enable\\\":1},\\\"stream_suffix\\\":\\\"uhd560\\\",\\\"cdn_name\\\":\\\"fcdn\\\",\\\"v_rtbitrate_timestamp\\\":1751748132527,\\\"v_rtbitrate_vpaas_timestamp\\\":1751748139608,\\\"resolution\\\":\\\"1080x1920\\\",\\\"v_rtbitrate_pct\\\":4371510,\\\"gop\\\":4,\\\"VCodec\\\":\\\"h265\\\",\\\"vbitrate\\\":4000000,\\\"v_rtbitrate\\\":4010510,\\\"v_rtpsnr\\\":0,\\\"v_rtbitrate_std\\\":408960}\"}},\"hd_60\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd560.flv?expire=1752957742&sign=a85b2ad3530d6e8f2202ee6e091b712d\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd560/index.m3u8?expire=1752957742&sign=23646c3dc06aa2b226e73dfd2cbd616c\",\"cmaf\":\"https://pull-cmaf-f30-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd560/index.mpd?expire=1752957742&sign=ed8c81047486469a3b05dd952f2a00b9\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836_hd560.sdp?expire=1752957742&sign=02813963eb9ebf398256ce723cd2c087\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"v_rtpsnr\\\":0,\\\"VCodec\\\":\\\"h265\\\",\\\"v_rtbitrate_vpaas_timestamp\\\":1751748139608,\\\"stream_suffix\\\":\\\"hd560\\\",\\\"resolution\\\":\\\"720x1280\\\",\\\"v_rtbitrate_pct\\\":3304860,\\\"vbitrate\\\":2600000,\\\"v_rtbitrate\\\":3209500,\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"v_rtbitrate_timestamp\\\":1751748133470,\\\"v_rtbitrate_std\\\":85690}\"}},\"ao\":{\"main\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/game/stream-3576322110592123836.flv?expire=1752957742&sign=e3deaa3e74cc33921accfe3e6165c407&only_audio=1\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"vbitrate\\\":0,\\\"resolution\\\":\\\"\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"Auto\\\":{\\\"Enable\\\":1,\\\"Demotion\\\":{\\\"StallCount\\\":4}},\\\"VCodec\\\":\\\"h264\\\"}\"}}}}"}}}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/live":{"post":{"operationId":"social_tiktok_live","x-nexscope-slug":"social-tiktok-live","summary":"TikTok Live Info","description":"Gets curated room-level info for a TikTok live from TikTok's public live-room source. Use `/v1/tiktok/user/live` first to find the `room_id`. If you only have a TikTok handle and need the user's numeric id, use `/v1/tiktok/profile` first to get `user.id`. This endpoint is separate from `/v1/tiktok/user/live` because it uses a different upstream call and returns a smaller response with the most relevant fields: `room_id`, `like_count`, `viewer_count`, `status`, `title`, `cover_url`, and `owner`. TikTok's room-access refusal returns HTTP 403 with no credit charge. The creator may have enabled audience controls; this response does not mean the profile was deleted. Other upstream failures remain errors rather than successful empty rooms. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Live Info API View Pricing Gets info for a TikTok live room, including like count. Returns 403 at no charge when TikTok refuses access to the room. 1 credit per request\nGets curated room-level info for a TikTok live from TikTok's public live-room source. Use `/v1/tiktok/user/live` first to find the `room_id`. If you only have a TikTok handle and need the user's numeric id, use `/v1/tiktok/profile` first to get `user.id`. This endpoint is separate from `/v1/tiktok/user/live` because it uses a different upstream call and returns a smaller response with the most relevant fields: `room_id`, `like_count`, `viewer_count`, `status`, `title`, `cover_url`, and `owner`. TikTok's room-access refusal returns HTTP 403 with no credit charge. The creator may have enabled audience controls; this response does not mean the profile was deleted. Other upstream failures remain errors rather than successful empty rooms.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"room_id":{"type":"string","description":"TikTok live room id. Get this from `/v1/tiktok/user/live` in `liveRoomUserInfo.roomId` or `liveRoom.id` when the user is live."},"user_id":{"type":"string","description":"TikTok numeric user id for the live owner. Get this from `/v1/tiktok/profile` in `user.id`."}},"required":["room_id","user_id"],"additionalProperties":false},"example":{"room_id":"7523685855395842871","user_id":"6742945285876515845"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"room_id":"7523685855395842871","like_count":4317,"viewer_count":268,"status":"live","title":"6'13 Grateful Streamer","cover_url":"https://p16-webcast.tiktokcdn-us.com/webcast/cover.jpeg","owner":{"id":"6742945285876515845","username":"thejustalex","display_name":"JustAlex"}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/video/comments":{"post":{"operationId":"social_tiktok_video_comments","x-nexscope-slug":"social-tiktok-video-comments","summary":"TikTok Comments","description":"Fetches comments on a TikTok video by URL — useful for reading audience reactions, replies, and engagement. Returns `comments`, an array where each comment includes `text`, `digg_count` (likes), `reply_comment_total`, `create_time`, and a `user` object with the commenter's nickname and unique_id; also returns `total` comment count. Paginate with `cursor` from the previous response. Public photo/slideshow posts are supported as well as videos. Comments use a separate TikTok public web source, so successful single-post metadata retrieval does not guarantee readable comments. An empty terminal page does not by itself prove the post has no comments globally or was deleted. This endpoint does not expose a country-selection parameter. Use the returned cursor and stop when `end_of_pagination=true`. Pages that return comments cost 1 credit; successful empty pages cost 0 credits, including the first page, later pages, and trim=true responses. Replaying a terminal null cursor also costs 0 credits. [Examples and troubleshooting](https://docs.scrapecreators.com/tiktok-post-availability). Scrapes comments from public TikTok videos and photo/slideshow posts. Pages with comments cost 1 credit; empty pages cost 0 credits. An empty page does not prove the post has no comments globally. [Examples and troubleshooting](https://docs.scrapecreators.com/tiktok-post-availability). Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Comments API View Pricing Get comments on public TikTok videos or slideshows. Pages with comments cost 1 credit; empty pages cost 0. An empty page does not prove the post has no comments globally. 1 credit per page with comments; 0 credits for empty pages\nFetches comments on a TikTok video by URL — useful for reading audience reactions, replies, and engagement. Returns `comments`, an array where each comment includes `text`, `digg_count` (likes), `reply_comment_total`, `create_time`, and a `user` object with the commenter's nickname and unique_id; also returns `total` comment count. Paginate with `cursor` from the previous response. Public photo/slideshow posts are supported as well as videos. Comments use a separate TikTok public web source, so successful single-post metadata retrieval does not guarantee readable comments. An empty terminal page does not by itself prove the post has no comments globally or was deleted. This endpoint does not expose a country-selection parameter. Use the returned cursor and stop when `end_of_pagination=true`. Pages that return comments cost 1 credit; successful empty pages cost 0 credits, including the first page, later pages, and trim=true responses. Replaying a terminal null cursor also costs 0 credits. [Examples and troubleshooting](https://docs.scrapecreators.com/tiktok-post-availability). Scrapes comments from public TikTok videos and photo/slideshow posts. Pages with comments cost 1 credit; empty pages cost 0 credits. An empty page does not prove the post has no comments globally. [Examples and troubleshooting](https://docs.scrapecreators.com/tiktok-post-availability).","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"TikTok video URL"},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"},"cursor":{"type":"number","description":"Cursor to get more comments. Get 'cursor' from previous response."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.tiktok.com/@stoolpresidente/video/7499229683859426602"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"comments":[{"aweme_id":"7517114944362499342","text":"DAVE BUY A TEAM","user":{"account_labels":null,"ad_cover_url":null,"advance_feature_item_order":null,"advanced_feature_info":null,"avatar_thumb":{"uri":"tos-useast5-avt-0068-tx/446370164449562d1008889225530f6d","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/446370164449562d1008889225530f6d~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=662e5e49&x-expires=1750374000&x-signature=a6DJxD8%2BkNeZRm7Sfpjc55T8mhE%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=useast5"],"url_prefix":null},"bold_fields":null,"can_message_follow_status_list":null,"can_set_geofencing":null,"cha_list":null,"cover_url":null,"custom_verify":"","enterprise_verify_reason":"","events":null,"followers_detail":null,"geofencing":null,"homepage_bottom_toast":null,"item_list":null,"mutual_relation_avatars":null,"need_points":null,"nickname":"Robert Lessner","platform_sync_info":null,"relative_users":null,"search_highlight":null,"sec_uid":"MS4wLjABAAAA9rB4k_Ei3NexA5p2lb8naaa4LTgNCOdY0W9NHVo63016XkdsuZgvjkgolBnUkG8W","shield_edit_field_info":null,"type_label":null,"uid":"6958917445306926086","unique_id":"dimebag.duster","user_profile_guide":null,"user_tags":null,"white_cover_url":null},"create_time":1750216932,"reply_comment_total":14,"digg_count":3322,"comment_language":"en"}],"cursor":20,"total":1114},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/video/comment/replies":{"post":{"operationId":"social_tiktok_video_comment_replies","x-nexscope-slug":"social-tiktok-video-comment-replies","summary":"TikTok Comment Replies","description":"Fetches replies to a specific TikTok comment by its ID. Returns `comments`, an array of comment objects each with `text`, `user` info, and `create_time`. Paginate with `cursor` from the previous response. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Comment Replies API View Pricing Scrapes replies to a TikTok comment 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"comment_id":{"type":"string","description":"TikTok comment ID. This is the cid from the comments endpoint."},"url":{"type":"string","description":"TikTok video URL. This is the url from the comments endpoint."},"cursor":{"type":"number","description":"Cursor to get more replies. Get 'cursor' from previous response."}},"required":["comment_id","url"],"additionalProperties":false},"example":{"comment_id":"7623828115408274207","url":"https://www.tiktok.com/@stoolpresidente/video/7623818255903329566"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"comments":[{"aweme_id":"7623818255903329566","cid":"7623874021293212447","collect_stat":0,"comment_language":"en","comment_post_item_ids":null,"create_time":1775071525,"digg_count":3,"fold_status":0,"image_list":null,"is_author_digged":false,"is_comment_translatable":true,"is_high_purchase_intent":false,"label_list":null,"no_show":false,"reply_comment":null,"reply_id":"7623828115408274207","reply_to_reply_id":"0","share_info":{"acl":{"code":1,"extra":"{\"is_share_handler_failed\":\"1\"}"},"desc":"","title":"","url":""},"status":1,"stick_position":0,"text":"Brilliant","text_extra":[],"thread_has_more":false,"thread_id":4,"trans_btn_style":0,"user":{"account_labels":null,"ad_cover_url":null,"advance_feature_item_order":null,"advanced_feature_info":null,"avatar_thumb":{"uri":"tos-useast5-avt-0068-tx/93d55c77c594984967fe43b4a657912e","url_list":["https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/93d55c77c594984967fe43b4a657912e~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=21a0ec0e&x-expires=1775250000&x-signature=vqdvvwo3gQAIiccDNbj%2B3KBK27Q%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=useast5"],"url_prefix":null},"bold_fields":null,"can_message_follow_status_list":null,"can_set_geofencing":null,"cha_list":null,"cover_url":null,"custom_verify":"","enterprise_verify_reason":"","events":null,"followers_detail":null,"geofencing":null,"homepage_bottom_toast":null,"item_list":null,"mutual_relation_avatars":null,"need_points":null,"nickname":"Katy","platform_sync_info":null,"predicted_age_group":"4","relative_users":null,"search_highlight":null,"sec_uid":"MS4wLjABAAAAGQCGrZCPx6snYndsBtuAIif17vTOTEfDZ9qd_9yCZlhb3iU0q19qTWYg8xXSwMng","shield_edit_field_info":null,"type_label":null,"uid":"6813803505255154693","unique_id":"katylynnm","user_profile_guide":null,"user_tags":null,"white_cover_url":null},"user_buried":false,"user_digged":0}],"cursor":6,"extra":{"fatal_item_ids":[],"logid":"2026040221232018E558310EA56D7D6188","now":1775165000000},"has_more":1,"log_pb":{"impr_id":"2026040221232018E558310EA56D7D6188"},"status_code":0,"status_msg":"","total":36},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/user/following":{"post":{"operationId":"social_tiktok_user_following","x-nexscope-slug":"social-tiktok-user-following","summary":"TikTok Following","description":"Retrieves the following list — accounts that a TikTok user follows — by their handle. Returns `followings`, an array of user objects each with `nickname`, `unique_id`, `uid`, `follower_count`, `following_count`, `signature`, and avatar URLs; also returns `total` count. Paginate with `min_time` from the previous response. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Following API View Pricing Scrapes accounts that a TikTok user follows 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"TikTok handle"},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"},"min_time":{"type":"number","description":"Used to paginate. Get 'min_time' from previous response."}},"required":["handle"],"additionalProperties":false},"example":{"handle":"stoolpresidente"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"followings":[{"create_time":1748628014,"follower_count":2175,"following_count":10,"language":"en","nickname":"Barstool Beach House","region":"US","sec_uid":"MS4wLjABAAAAbQK_EH0QRu1Wqk9mXsWvWW2dGpK1_LSiVdJx0oXtFCE_oOX8RIeGFfaYJQthUoaH","signature":"Coming in August","uid":"7510299285881160735","unique_id":"barstoolbeachhouse","avatar_medium":{"height":720,"uri":"tos-maliva-avt-0068/14f24ed9e7e1b1fc6764375b799c6ed7","url_list":["https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/14f24ed9e7e1b1fc6764375b799c6ed7~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&refresh_token=a5540255&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1750374000&x-signature=RDNAkREIu7HN1Tk8QeklmwFkSJY%3D"],"url_prefix":null,"width":720}}],"min_time":1734010829,"total":81},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/user/followers":{"post":{"operationId":"social_tiktok_user_followers","x-nexscope-slug":"social-tiktok-user-followers","summary":"TikTok Followers","description":"Retrieves the follower list of a TikTok account by handle or user_id — useful for seeing who follows a creator or getting subscriber data. Returns `followers`, an array of user objects each with `nickname`, `unique_id`, `uid`, `follower_count`, `following_count`, and avatar URLs; also returns `total` follower count. Paginate with `min_time` from the previous response. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Followers API View Pricing Scrapes followers of a TikTok account 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"TikTok handle"},"user_id":{"type":"string","description":"User id. Use this for faster response times."},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"},"min_time":{"type":"number","description":"Used to paginate. Get 'min_time' from previous response."}},"required":[],"additionalProperties":false},"example":{"handle":"stoolpresidente"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"followers":[{"create_time":1585489718,"follower_count":319,"following_count":1375,"language":"en","nickname":"Kelsey Levens Haskin","region":"US","sec_uid":"MS4wLjABAAAAG-DXjA9PmiU6daPQzr9ux9Xr8EQ_SU_STIlWxqs2huXTZR94IdbY2kpoGhiSzAxn","signature":"","uid":"6802639142851609605","unique_id":"klh723","avatar_medium":{"height":720,"uri":"tos-maliva-avt-0068/7324817662562402310","url_list":["https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7324817662562402310~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&refresh_token=ae851b19&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1750374000&x-signature=VOyI618znRkoyH0BRwF3FLvnKKY%3D"],"url_prefix":null,"width":720}}],"min_time":1750289478,"total":4424847},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/search/users":{"post":{"operationId":"social_tiktok_search_users","x-nexscope-slug":"social-tiktok-search-users","summary":"TikTok Search Users","description":"Searches for TikTok users by keyword or name — useful for finding creators or accounts matching a query. Returns `users`, an array of objects each containing `user_info` (nickname, unique_id, signature/bio, follower_count, following_count, avatar) and associated `items`. Paginate with `cursor` from the previous response. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Search Users API View Pricing Scrapes TikTok users matching a search query 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for users"},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"},"cursor":{"type":"number","description":"Cursor to get more users. Get 'cursor' from previous response."}},"required":["query"],"additionalProperties":false},"example":{"query":"coffee"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"users":[{"follower_count":163953,"following_count":63,"nickname":"ADRIAN","sec_uid":"MS4wLjABAAAAcT5kdL_w3D2p3a3DkULhrVE6Ir17Ua1M9GZK4cnvnKxbJg3qy0xDdbaFeY260Qzz","uid":"6757029651601835013","unique_id":"adrianzyno","avatar_medium":{"height":720,"uri":"tos-maliva-avt-0068/60a12c00b42288dd3503cf3025165093","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/60a12c00b42288dd3503cf3025165093~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4"],"url_prefix":null,"width":720}}],"cursor":30},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/search/suggestions":{"post":{"operationId":"social_tiktok_search_suggestions","x-nexscope-slug":"social-tiktok-search-suggestions","summary":"TikTok Search Suggestions","description":"Gets the autocomplete suggestions TikTok shows while someone is typing in search. Returns `suggestions`, a clean array of suggested search terms and the most useful metadata for each suggestion. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Search Suggestions API View Pricing Gets TikTok autocomplete search suggestions for a query. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query to get suggestions for"},"region":{"type":"string","description":"Region code for suggestions"}},"required":["query"],"additionalProperties":false},"example":{"query":"dogs"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"suggestions":[{"text":"dogs cute","position":0,"language":"en","score":0.011535803}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/search/hashtag":{"post":{"operationId":"social_tiktok_search_hashtag","x-nexscope-slug":"social-tiktok-search-hashtag","summary":"TikTok Search by Hashtag","description":"Searches for TikTok videos under a specific hashtag — useful for finding content by topic or trend. Returns `aweme_list`, an array of video objects each with `aweme_id`, `desc` (caption), `statistics` (play_count, digg_count/likes, comment_count, share_count), `video` info, and `author` details. Paginate with `cursor` from the previous response. TikTok may return duplicate results. Scrapes TikTok videos by hashtag. Note: TikTok can return duplicate results for this search. Sorry about that — it looks like a TikTok-side thing, so we don't have control over it. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Search by Hashtag API View Pricing Search TikTok videos by hashtag. TikTok may return duplicate results. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hashtag":{"type":"string","description":"Hashtag to search for (without #)"},"region":{"type":"string","description":"Region the proxy will be set to. Note: this isn't going to grab you all tiktoks from this region, you're just setting the proxy there."},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"},"cursor":{"type":"number","description":"Cursor to get more videos. Get 'cursor' from previous response."}},"required":["hashtag"],"additionalProperties":false},"example":{"hashtag":"coffee"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"aweme_list":[{"aweme_id":"7277923990184742177","desc":"best boys #friends #joeytribbiani #chandlerbing #joeyandchandler #sitcom #mecore #uscore #bromance #matthewperry #mattleblanc ","desc_language":"en","region":"DE","statistics":{"aweme_id":"7277923990184742177","collect_count":385471,"comment_count":94635,"digg_count":2840077,"download_count":1318,"forward_count":0,"lose_comment_count":0,"lose_count":0,"play_count":12711728,"repost_count":0,"share_count":614428,"whatsapp_share_count":19390},"video":{"CoverTsp":7.68255116568915,"ai_dynamic_cover":{"uri":"tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739","url_list":["https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739~tplv-tiktokx-origin.image?dr=9229&refresh_token=c493f93a&x-expires=1750377600&x-signature=zaHE9yF93tRa0sZXJA%2FE5yrYa3I%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c0f880ed&idc=no1a&biz_tag=tt_video&s=CHALLENGE_AWEME&sc=dynamic_cover"],"url_prefix":null},"ai_dynamic_cover_bak":{"uri":"tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739","url_list":["https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739~tplv-tiktokx-origin.image?dr=9229&refresh_token=c493f93a&x-expires=1750377600&x-signature=zaHE9yF93tRa0sZXJA%2FE5yrYa3I%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c0f880ed&idc=no1a&biz_tag=tt_video&s=CHALLENGE_AWEME&sc=dynamic_cover"],"url_prefix":null},"animated_cover":{"uri":"tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739","url_list":["https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739~tplv-tiktokx-origin.image?dr=9229&refresh_token=c493f93a&x-expires=1750377600&x-signature=zaHE9yF93tRa0sZXJA%2FE5yrYa3I%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c0f880ed&idc=no1a&biz_tag=tt_video&s=CHALLENGE_AWEME&sc=dynamic_cover"],"url_prefix":null},"big_thumbs":[],"bit_rate":[{"HDR_bit":"","HDR_type":"","bit_rate":364924,"dub_infos":null,"fid_profile_labels":"","fps":30,"gear_name":"adapt_540_1","is_bytevc1":1,"play_addr":{"data_size":759407,"file_cs":"c:0-15397-6132","file_hash":"f44716c0f1de35c8618470f551dde04b","height":576,"uri":"v0f044gc0000ck062fbc77uc8kdoc7ig","url_key":"v0f044gc0000ck062fbc77uc8kdoc7ig_bytevc1_540p_364924","url_list":["https://v45.tiktokcdn-eu.com/339e98fc0becce4e1728c5ef64d69b69/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068-euttp/o4LNPmDIQDQl9hAbjwePAS4MK1EcfEAinBGRXY/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=712&bt=356&cs=2&ds=6&ft=td_Lr8QLodzR12Nv9N6PWIxRJNz_XF_45SY&mime_type=video_mp4&qs=11&rc=OmRkODVmaDQzMzpmZDM2NUBpajpybmY6Zmk5bjMzZjczM0BjNGE0YmExNi8xYi8wLmNgYSNmYGE1cjRfLy1gLS1kMWNzcw%3D%3D&vvpl=1&l=20250619081826AED41EFE5DB89F3D8698&btag=e000bd000"],"url_prefix":null,"width":576},"quality_type":28,"video_extra":"{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 105212}, {\\\"time\\\": 2, \\\"offset\\\": 155336}, {\\\"time\\\": 3, \\\"offset\\\": 188263}, {\\\"time\\\": 4, \\\"offset\\\": 240132}, {\\\"time\\\": 5, \\\"offset\\\": 297488}, {\\\"time\\\": 10, \\\"offset\\\": 500467}]\",\"mvmaf\":\"\",\"ufq\":\"\",\"volume_info_json\":\"\",\"transcode_feature_id\":\"9a60c2c4c41021710925f796744dd9e0\",\"dec_info\":\"\",\"gearvqm\":\"\"}"}],"bit_rate_audio":[],"cdn_url_expired":0,"cla_info":{"caption_infos":null,"captions_type":0,"creator_edited_caption_id":0,"enable_auto_caption":0,"has_original_audio":0,"hide_original_caption":false,"no_caption_reason":3,"vertical_positions":null},"cover":{"height":720,"uri":"tos-useast2a-p-0037-euttp/7eb5601a4f4b4134b8321955a5ceb515_1694523738","url_list":["https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/7eb5601a4f4b4134b8321955a5ceb515_1694523738~tplv-tiktokx-origin.image?dr=1347&refresh_token=04c0a26b&x-expires=1750377600&x-signature=D80fHwx2YQmu%2Bs7fKVs6JvfrDwo%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=c0f880ed&idc=no1a&sc=cover&biz_tag=tt_video&s=CHALLENGE_AWEME"],"url_prefix":null,"width":720},"cover_is_custom":true,"did_profile_labels":"","download_addr":{"data_size":1645666,"file_cs":"c:0-15212-b6fb","height":720,"uri":"v0f044gc0000ck062fbc77uc8kdoc7ig","url_list":["https://v45.tiktokcdn-eu.com/de0e8da0f33c14a280afb63dbbd7200f/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068c001-euttp/oYBtGfE0AWGREzMHElYDeRkucMhEAlDPQQBAIR/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1544&bt=772&cs=0&ds=3&ft=td_Lr8QLodzR12Nv9N6PWIxRJNz_XF_45SY&mime_type=video_mp4&qs=0&rc=aWRoOmY3NDg5N2hlZzM7NUBpajpybmY6Zmk5bjMzZjczM0BhMDQvXjQtNWExNDYzLzReYSNmYGE1cjRfLy1gLS1kMWNzcw%3D%3D&vvpl=1&l=20250619081826AED41EFE5DB89F3D8698&btag=e000bd000"],"url_prefix":null,"width":720},"download_no_watermark_addr":{"data_size":1596498,"file_cs":"c:0-15212-b6fb","file_hash":"865acc2a4a685aa6fe71256e1f7c8510","height":576,"uri":"v0f044gc0000ck062fbc77uc8kdoc7ig","url_key":"v0f044gc0000ck062fbc77uc8kdoc7ig_h264_540p_767178","url_list":["https://v45.tiktokcdn-eu.com/a99d33899bc03dd0c27ade23be118c55/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068-euttp/osjwrgDKl4DecPcABYeDQEn9EAARrtCIQibMPG/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1498&bt=749&cs=0&ds=6&ft=td_Lr8QLodzR12Nv9N6PWIxRJNz_XF_45SY&mime_type=video_mp4&qs=0&rc=NDQ0ZDs3OWVpPGhkO2Q4aEBpajpybmY6Zmk5bjMzZjczM0A0YjJfLWBiNS0xXjNjYGIvYSNmYGE1cjRfLy1gLS1kMWNzcw%3D%3D&vvpl=1&l=20250619081826AED41EFE5DB89F3D8698&btag=e000bd000"],"url_prefix":null,"width":576},"duration":16648,"dynamic_cover":{"height":720,"uri":"tos-useast2a-p-0037-euttp/d1dfbab565b84a92ad94eca69e455a4c_1694523739","url_list":["https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/d1dfbab565b84a92ad94eca69e455a4c_1694523739~tplv-tiktokx-origin.image?dr=9229&refresh_token=508a3268&x-expires=1750377600&x-signature=KsNxQZIhu4mTRZLEkpl%2FgG0WJVE%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c0f880ed&idc=no1a&biz_tag=tt_video&s=CHALLENGE_AWEME&sc=dynamic_cover"],"url_prefix":null,"width":720},"has_watermark":true,"height":576,"is_bytevc1":0,"is_callback":true,"meta":"{\"LoudnessRange\":\"0.7\",\"LoudnessRangeEnd\":\"-9.5\",\"LoudnessRangeStart\":\"-10.2\",\"MaximumMomentaryLoudness\":\"-7.7\",\"MaximumShortTermLoudness\":\"-9.4\",\"Version\":\"1\",\"VolumeInfoJson\":\"{\\\"LoudnessRangeStart\\\":-10.2,\\\"Version\\\":1,\\\"LoudnessRangeEnd\\\":-9.5,\\\"LoudnessRange\\\":0.7,\\\"Peak\\\":1,\\\"Loudness\\\":-10,\\\"MaximumMomentaryLoudness\\\":-7.7,\\\"MaximumShortTermLoudness\\\":-9.4}\",\"flight_id\":\"\",\"loudness\":\"-10\",\"peak\":\"1\",\"play_time_prob_dist\":\"[800,0.801,3121.2698]\",\"sr_score\":\"1.000\",\"vq_score\":\"55.37\"}","misc_download_addrs":"{\"suffix_scene\":{\"uri\":\"v0f044gc0000ck062fbc77uc8kdoc7ig\",\"url_list\":[\"https://v45.tiktokcdn-eu.com/4f9aadaa474b036d50f519f6afd2bd4d/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068c001-euttp/o0EAztMeEhDPExJHRQlQfBRRIKRGAoGlFDFBuz/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1288&bt=644&cs=0&ds=3&ft=td_Lr8QLodzR12Nv9N6PWIxRJNz_XF_45SY&mime_type=video_mp4&qs=0&rc=NzY5Mzc7ZTpkN2llOWQ6NkBpajpybmY6Zmk5bjMzZjczM0A1YTRgNTNfNl8xX15fL2E2YSNmYGE1cjRfLy1gLS1kMWNzcw%3D%3D&vvpl=1&l=20250619081826AED41EFE5DB89F3D8698&btag=e000bd000\",\"https://v16m.tiktokcdn-eu.com/68473afcbc37657465779bf3399bc190/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068c001-euttp/o0EAztMeEhDPExJHRQlQfBRRIKRGAoGlFDFBuz/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1288&bt=644&cs=0&ds=3&ft=td_Lr8QLodzR12Nv9N6PWIxRJNz_XF_45SY&mime_type=video_mp4&qs=0&rc=NzY5Mzc7ZTpkN2llOWQ6NkBpajpybmY6Zmk5bjMzZjczM0A1YTRgNTNfNl8xX15fL2E2YSNmYGE1cjRfLy1gLS1kMWNzcw%3D%3D&vvpl=1&l=20250619081826AED41EFE5DB89F3D8698&btag=e000b8000\",\"https://api16-normal-no1a.tiktokv.eu/aweme/v1/play/?video_id=v0f044gc0000ck062fbc77uc8kdoc7ig&line=0&watermark=1&logo_name=tiktok_end_sonic&source=CHALLENGE_AWEME&file_id=93d72ab6abbf44ba97bb6884c076d384&item_id=7277923990184742177&signaturev3=dmlkZW9faWQ7ZmlsZV9pZDtpdGVtX2lkLjQ5OTFhNGQ5OGNhMTY1MTZkZGUyMzQ3YWRjOTZjNTgx&shp=d05b14bd&shcp=-\"],\"width\":720,\"height\":720,\"data_size\":1705867,\"file_cs\":\"c:0-15212-b6fb\",\"url_prefix\":null}}","need_set_token":false,"origin_cover":{"height":720,"uri":"tos-useast2a-p-0037-euttp/8645744258524a9eb63d68fac73a3fd2_1694523738","url_list":["https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/8645744258524a9eb63d68fac73a3fd2_1694523738~tplv-dmt-adapt-360p.heic?dr=1360&refresh_token=262a17a9&x-expires=1750377600&x-signature=1EZLLyR6gut1idQPWSTz6KJLaWk%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=c0f880ed&idc=no1a&s=CHALLENGE_AWEME&sc=feed_cover&biz_tag=tt_video"],"url_prefix":null,"width":720},"play_addr":{"data_size":1596498,"file_cs":"c:0-15212-b6fb","file_hash":"865acc2a4a685aa6fe71256e1f7c8510","height":576,"uri":"v0f044gc0000ck062fbc77uc8kdoc7ig","url_key":"v0f044gc0000ck062fbc77uc8kdoc7ig_h264_540p_767178","url_list":["https://v45.tiktokcdn-eu.com/a99d33899bc03dd0c27ade23be118c55/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068-euttp/osjwrgDKl4DecPcABYeDQEn9EAARrtCIQibMPG/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1498&bt=749&cs=0&ds=6&ft=td_Lr8QLodzR12Nv9N6PWIxRJNz_XF_45SY&mime_type=video_mp4&qs=0&rc=NDQ0ZDs3OWVpPGhkO2Q4aEBpajpybmY6Zmk5bjMzZjczM0A0YjJfLWBiNS0xXjNjYGIvYSNmYGE1cjRfLy1gLS1kMWNzcw%3D%3D&vvpl=1&l=20250619081826AED41EFE5DB89F3D8698&btag=e000bd000"],"url_prefix":null,"width":576},"play_addr_bytevc1":{"data_size":759407,"file_cs":"c:0-15397-6132","file_hash":"f44716c0f1de35c8618470f551dde04b","height":576,"uri":"v0f044gc0000ck062fbc77uc8kdoc7ig","url_key":"v0f044gc0000ck062fbc77uc8kdoc7ig_bytevc1_540p_364924","url_list":["https://v45.tiktokcdn-eu.com/339e98fc0becce4e1728c5ef64d69b69/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068-euttp/o4LNPmDIQDQl9hAbjwePAS4MK1EcfEAinBGRXY/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=712&bt=356&cs=2&ds=6&ft=td_Lr8QLodzR12Nv9N6PWIxRJNz_XF_45SY&mime_type=video_mp4&qs=11&rc=OmRkODVmaDQzMzpmZDM2NUBpajpybmY6Zmk5bjMzZjczM0BjNGE0YmExNi8xYi8wLmNgYSNmYGE1cjRfLy1gLS1kMWNzcw%3D%3D&vvpl=1&l=20250619081826AED41EFE5DB89F3D8698&btag=e000bd000"],"url_prefix":null,"width":576},"play_addr_h264":{"data_size":1596498,"file_cs":"c:0-15212-b6fb","file_hash":"865acc2a4a685aa6fe71256e1f7c8510","height":576,"uri":"v0f044gc0000ck062fbc77uc8kdoc7ig","url_key":"v0f044gc0000ck062fbc77uc8kdoc7ig_h264_540p_767178","url_list":["https://v45.tiktokcdn-eu.com/a99d33899bc03dd0c27ade23be118c55/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068-euttp/osjwrgDKl4DecPcABYeDQEn9EAARrtCIQibMPG/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1498&bt=749&cs=0&ds=6&ft=td_Lr8QLodzR12Nv9N6PWIxRJNz_XF_45SY&mime_type=video_mp4&qs=0&rc=NDQ0ZDs3OWVpPGhkO2Q4aEBpajpybmY6Zmk5bjMzZjczM0A0YjJfLWBiNS0xXjNjYGIvYSNmYGE1cjRfLy1gLS1kMWNzcw%3D%3D&vvpl=1&l=20250619081826AED41EFE5DB89F3D8698&btag=e000bd000"],"url_prefix":null,"width":576},"ratio":"540p","source_HDR_type":0,"tags":null,"vid_profile_labels":"{\"tier3\":\"10045\"}","width":576},"author":{"accept_private_policy":false,"account_labels":null,"account_region":"","ad_cover_url":null,"advance_feature_item_order":null,"advanced_feature_info":null,"apple_account":0,"authority_status":0,"avatar_168x168":{"height":720,"uri":"tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931","url_list":["https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&s=CHALLENGE_AWEME&sc=avatar&shcp=c0f880ed&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_300x300":{"height":720,"uri":"tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931","url_list":["https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&idc=no1a&ps=87d6e48a&s=CHALLENGE_AWEME&sc=avatar&shcp=c0f880ed&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_larger":{"height":720,"uri":"tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931","url_list":["https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&s=CHALLENGE_AWEME&sc=avatar&shcp=c0f880ed&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_medium":{"height":720,"uri":"tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931","url_list":["https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&s=CHALLENGE_AWEME&sc=avatar&shcp=c0f880ed&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_thumb":{"height":720,"uri":"tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931","url_list":["https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606&idc=no1a&ps=87d6e48a&s=CHALLENGE_AWEME&sc=avatar&shcp=c0f880ed&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_uri":"tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931","aweme_count":0,"bind_phone":"","bold_fields":null,"can_message_follow_status_list":[2],"can_set_geofencing":null,"cha_list":null,"comment_filter_status":0,"comment_setting":0,"commerce_user_level":0,"cover_url":[],"create_time":0,"custom_verify":"","cv_level":"","download_prompt_ts":0,"download_setting":0,"duet_setting":0,"enabled_filter_all_comments":false,"enterprise_verify_reason":"","events":null,"fake_data_info":{},"favoriting_count":0},"is_eligible_for_commission":true,"is_paid_partnership":false,"create_time_utc":"2025-09-03T18:37:38.000Z","url":"https://www.tiktok.com/@branttakes/video/7545933721589910798","shop_product_url":"https://www.tiktok.com/shop/pdp/1729494515984797858"}],"cursor":20},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/search/keyword":{"post":{"operationId":"social_tiktok_search_keyword","x-nexscope-slug":"social-tiktok-search-keyword","summary":"TikTok Search by Keyword","description":"Searches for TikTok videos by keyword or phrase — the general video search across all of TikTok. Returns `search_item_list`, an array of objects each containing `aweme_info` with `aweme_id`, `desc` (caption), `statistics` (play_count, digg_count/likes, comment_count, share_count), `video` info, and `author` details. Paginate with `cursor`. TikTok may return duplicate results. Scrapes TikTok videos matching a keyword. Note: TikTok can return duplicate results for this search. Sorry about that — it looks like a TikTok-side thing, so we don't have control over it. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Search by Keyword API View Pricing Search TikTok videos by keyword. TikTok may return duplicate results. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Keyword to search for"},"date_posted":{"type":"string","enum":["yesterday","this-week","this-month","last-3-months","last-6-months","all-time"],"description":"Time Frame"},"sort_by":{"type":"string","enum":["relevance","most-liked","date-posted"],"description":"Sort by"},"region":{"type":"string","description":"Note, this doesn't filter the tiktoks only in a specfic region, it puts the proxy there. Use it in case you want to scrape posts only available for some country. Use 2 letter country codes like US, GB, FR, etc"},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"},"cursor":{"type":"number","description":"Cursor to get more videos. Get 'cursor' from previous response."}},"required":["query"],"additionalProperties":false},"example":{"query":"coffee"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"search_item_list":[{"aweme_id":"7268287584244124971","desc":"Tìm 'musclesandnursing'","desc_language":"vi","region":"US","statistics":{"aweme_id":"7268287584244124971","collect_count":6978,"comment_count":187,"digg_count":481608,"download_count":458,"forward_count":0,"lose_comment_count":0,"lose_count":0,"play_count":1282645,"repost_count":0,"share_count":2721,"whatsapp_share_count":56},"video":{"CoverTsp":0,"ai_dynamic_cover":{"uri":"tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121~tplv-tiktokx-origin.image?dr=9229&refresh_token=f517ff94&x-expires=1750438800&x-signature=D3imLVwGqpA9zsbLqnvdO%2FafuVs%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c1333099&idc=no1a&sc=dynamic_cover&biz_tag=tt_video&s=SEARCH"],"url_prefix":null},"ai_dynamic_cover_bak":{"uri":"tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121~tplv-tiktokx-origin.image?dr=9229&refresh_token=f517ff94&x-expires=1750438800&x-signature=D3imLVwGqpA9zsbLqnvdO%2FafuVs%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c1333099&idc=no1a&sc=dynamic_cover&biz_tag=tt_video&s=SEARCH"],"url_prefix":null},"animated_cover":{"uri":"tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121~tplv-tiktokx-origin.image?dr=9229&refresh_token=f517ff94&x-expires=1750438800&x-signature=D3imLVwGqpA9zsbLqnvdO%2FafuVs%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c1333099&idc=no1a&sc=dynamic_cover&biz_tag=tt_video&s=SEARCH"],"url_prefix":null},"big_thumbs":[],"bit_rate":[{"HDR_bit":"","HDR_type":"","bit_rate":1225469,"dub_infos":null,"fid_profile_labels":"","fps":30,"gear_name":"normal_540_0","is_bytevc1":0,"play_addr":{"data_size":3503925,"file_cs":"c:0-20264-cec0","file_hash":"2e54ea91b0d4db38c7e631f3e5d316a0","height":1024,"uri":"v12025gd0000cjf2aabc77u3cqbmfgsg","url_key":"v12025gd0000cjf2aabc77u3cqbmfgsg_h264_540p_1225469","url_list":["https://v45.tiktokcdn-eu.com/9376fcf5b7e4e4056ac2238e8a50a2d8/68559dc0/video/tos/maliva/tos-maliva-ve-0068c799-us/ooh8ViyMkQSGCrDGSB3eWuUDo7ngz8APpgbenS/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C0&cv=1&br=2392&bt=1196&cs=0&ds=6&ft=7Xz8TB95IxRfAhEv-RbzVgmaQ6KXtjST5fQEe5tdm-LD1Inz&mime_type=video_mp4&qs=0&rc=aGZlMzM8ODs5ZzY7ZzU8OEBpampwdDY6ZmQ1bTMzZzgzNEAyXjIvYWAwX2ExYzBfXzYvYSNwY19gcjRfXmNgLS1kLy9zcw%3D%3D&vvpl=1&l=20250619174305B003B50F09659366F6E1&btag=e000bd000"],"url_prefix":null,"width":576},"quality_type":20}],"bit_rate_audio":[],"cdn_url_expired":0,"cla_info":{"caption_infos":[{"caption_format":"webvtt","caption_length":438,"cla_subtitle_id":7270020544014290000,"complaint_id":7270020544014290000,"expire":1752947008,"is_auto_generated":true,"is_original_caption":true,"lang":"eng-US","language_code":"en","language_id":2,"source_tag":"vv_counter,","sub_id":-956551204,"sub_version":"1","subtitle_type":1,"translation_type":0,"translator_id":0,"url":"https://v16-cla.tiktokcdn.com/aaaf4ba5cf24681036ef3698a5d762b9/687bd940/video/tos/maliva/tos-maliva-v-0068c799-us/c2eeae68718f4599a720342941eca2bf/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C0&cv=1&br=2600&bt=1300&cs=0&ds=6&ft=BiFzHV~3wUxl7K2gUtIvk84jWLpiNOz~xjKJ~iu8gG0P3-I&mime_type=video_mp4&qs=13&rc=ampwdDY6ZmQ1bTMzZzgzNEBpampwdDY6ZmQ1bTMzZzgzNEBwY19gcjRfXmNgLS1kLy9zYSNwY19gcjRfXmNgLS1kLy9zcw%3D%3D&vvpl=1&l=20250619174305B003B50F09659366F6E1&btag=e00078000","url_list":["https://v16-cla.tiktokcdn.com/aaaf4ba5cf24681036ef3698a5d762b9/687bd940/video/tos/maliva/tos-maliva-v-0068c799-us/c2eeae68718f4599a720342941eca2bf/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C0&cv=1&br=2600&bt=1300&cs=0&ds=6&ft=BiFzHV~3wUxl7K2gUtIvk84jWLpiNOz~xjKJ~iu8gG0P3-I&mime_type=video_mp4&qs=13&rc=ampwdDY6ZmQ1bTMzZzgzNEBpampwdDY6ZmQ1bTMzZzgzNEBwY19gcjRfXmNgLS1kLy9zYSNwY19gcjRfXmNgLS1kLy9zcw%3D%3D&vvpl=1&l=20250619174305B003B50F09659366F6E1&btag=e00078000"],"variant":"default"}],"captions_type":1,"creator_edited_caption_id":0,"enable_auto_caption":0,"has_original_audio":0,"hide_original_caption":false,"no_caption_reason":0,"original_language_info":{"can_translate_realtime":false,"can_translate_realtime_skip_translation_lang_check":true,"first_subtitle_time":0,"is_burnin_caption":true,"lang":"eng-US","language_code":"en","language_id":2,"original_caption_type":5},"vertical_positions":null},"cover":{"height":720,"uri":"tos-useast5-p-0068-tx/0f577ee28df74315b4a8627da155b294","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/0f577ee28df74315b4a8627da155b294~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_video.video_cover&dr=10397&idc=no1a&ps=13740610&refresh_token=b8b3e6e4&shcp=9b759fb9&shp=c1333099&t=4d5b0474&x-expires=1750374000&x-signature=OmrZk9jL5t%2FLXtkV8oZOuLa3xvM%3D"],"url_prefix":null,"width":720},"did_profile_labels":"","download_addr":{"data_size":3577718,"height":720,"uri":"v12025gd0000cjf2aabc77u3cqbmfgsg","url_list":["https://v45.tiktokcdn-eu.com/53531e0e8cb8cabe9f9fb43d31f0477a/68559dc0/video/tos/maliva/tos-maliva-ve-0068c799-us/osgGPDi7kD0SShpGAnBhusf3egUQSobVpCSz8y/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C0&cv=1&br=2442&bt=1221&cs=0&ds=3&ft=7Xz8TB95IxRfAhEv-RbzVgmaQ6KXtjST5fQEe5tdm-LD1Inz&mime_type=video_mp4&qs=0&rc=ZGkzZDw8OzRpOzppNWk0OUBpampwdDY6ZmQ1bTMzZzgzNEBgMWAxLi0tXjQxNF5hYGIwYSNwY19gcjRfXmNgLS1kLy9zcw%3D%3D&vvpl=1&l=20250619174305B003B50F09659366F6E1&btag=e000bd000"],"url_prefix":null,"width":720},"download_no_watermark_addr":{"data_size":3503925,"file_cs":"c:0-20264-cec0","file_hash":"2e54ea91b0d4db38c7e631f3e5d316a0","height":1024,"uri":"v12025gd0000cjf2aabc77u3cqbmfgsg","url_key":"v12025gd0000cjf2aabc77u3cqbmfgsg_h264_540p_1225469","url_list":["https://v45.tiktokcdn-eu.com/9376fcf5b7e4e4056ac2238e8a50a2d8/68559dc0/video/tos/maliva/tos-maliva-ve-0068c799-us/ooh8ViyMkQSGCrDGSB3eWuUDo7ngz8APpgbenS/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C0&cv=1&br=2392&bt=1196&cs=0&ds=6&ft=7Xz8TB95IxRfAhEv-RbzVgmaQ6KXtjST5fQEe5tdm-LD1Inz&mime_type=video_mp4&qs=0&rc=aGZlMzM8ODs5ZzY7ZzU8OEBpampwdDY6ZmQ1bTMzZzgzNEAyXjIvYWAwX2ExYzBfXzYvYSNwY19gcjRfXmNgLS1kLy9zcw%3D%3D&vvpl=1&l=20250619174305B003B50F09659366F6E1&btag=e000bd000"],"url_prefix":null,"width":576},"duration":22874,"dynamic_cover":{"height":720,"uri":"tos-useast5-p-0068-tx/67ce9300736f4166847161d8b805eb29_1692280121","url_list":["https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/67ce9300736f4166847161d8b805eb29_1692280121~tplv-tiktokx-origin.image?dr=9229&refresh_token=8a667f0e&x-expires=1750438800&x-signature=61HY87iHMGwIIjamvp5W6BMWgZc%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c1333099&idc=no1a&s=SEARCH&sc=dynamic_cover&biz_tag=tt_video"],"url_prefix":null,"width":720},"has_watermark":true,"height":1024,"is_bytevc1":0,"is_callback":true,"need_set_token":false,"origin_cover":{"height":720,"uri":"tos-useast5-p-0068-tx/b077d60fb7304b5ca66c894b70eacd63_1692280121","url_list":["https://p19-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/b077d60fb7304b5ca66c894b70eacd63_1692280121~tplv-dmt-adapt-360p.heic?dr=1360&refresh_token=01618ed2&x-expires=1750438800&x-signature=enrj%2FQcrnnqO5EfF6R%2FI98%2F2GKA%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=c1333099&idc=no1a&sc=feed_cover&biz_tag=tt_video&s=SEARCH"],"url_prefix":null,"width":720},"play_addr":{"data_size":3503925,"file_cs":"c:0-20264-cec0","file_hash":"2e54ea91b0d4db38c7e631f3e5d316a0","height":1024,"uri":"v12025gd0000cjf2aabc77u3cqbmfgsg","url_key":"v12025gd0000cjf2aabc77u3cqbmfgsg_h264_540p_1225469","url_list":["https://v45.tiktokcdn-eu.com/9376fcf5b7e4e4056ac2238e8a50a2d8/68559dc0/video/tos/maliva/tos-maliva-ve-0068c799-us/ooh8ViyMkQSGCrDGSB3eWuUDo7ngz8APpgbenS/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C0&cv=1&br=2392&bt=1196&cs=0&ds=6&ft=7Xz8TB95IxRfAhEv-RbzVgmaQ6KXtjST5fQEe5tdm-LD1Inz&mime_type=video_mp4&qs=0&rc=aGZlMzM8ODs5ZzY7ZzU8OEBpampwdDY6ZmQ1bTMzZzgzNEAyXjIvYWAwX2ExYzBfXzYvYSNwY19gcjRfXmNgLS1kLy9zcw%3D%3D&vvpl=1&l=20250619174305B003B50F09659366F6E1&btag=e000bd000"],"url_prefix":null,"width":576},"ratio":"540p","source_HDR_type":0,"tags":null,"vid_profile_labels":"{\"tier3\":\"10014\"}","width":576},"author":{"accept_private_policy":false,"account_labels":null,"ad_cover_url":null,"advance_feature_item_order":null,"advanced_feature_info":null,"authority_status":0,"avatar_168x168":{"height":720,"uri":"tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_300x300":{"height":720,"uri":"tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_larger":{"height":720,"uri":"tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_medium":{"height":720,"uri":"tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_thumb":{"height":720,"uri":"tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777","url_list":["https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777~tplv-tiktokx-cropcenter-q:100:100:q70.heic?biz_tag=musically_video.video_user_cover&dr=9606&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_uri":"tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777","aweme_count":0,"bold_fields":null,"can_message_follow_status_list":null,"can_set_geofencing":null,"cha_list":null,"comment_filter_status":0,"comment_setting":0,"commerce_user_level":0,"cover_url":null,"custom_verify":"","cv_level":"","download_prompt_ts":0,"enabled_filter_all_comments":false,"enterprise_verify_reason":"","events":null,"fake_data_info":{},"fb_expire_time":0,"follow_status":0,"follower_count":147630,"follower_status":0,"followers_detail":null,"following_count":0,"friends_status":0},"create_time":1692280120,"is_ad":false,"is_eligible_for_commission":false,"create_time_utc":"2023-08-17T13:48:40.000Z","url":"https://www.tiktok.com/@thatgreygentlemanitdxz/video/7268287584244124971"}],"cursor":30},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/search/top":{"post":{"operationId":"social_tiktok_search_top","x-nexscope-slug":"social-tiktok-search-top","summary":"TikTok Top Search","description":"Searches TikTok's 'Top' results by query — returns both videos and photo carousels, unlike keyword search which only returns videos. Returns `items`, an array of objects each with `id`, `desc` (caption), `content_type` (video or photo carousel), `statistics` (play_count, digg_count/likes, comment_count, share_count), `video` info, and `images` for carousels. Paginate with `cursor`. TikTok may return duplicate results. There is a 'Top' Search in TikTok and this is that. You can get Photo Carousels and Videos. Whereas with just the Keyword Search, you can only get Videos. Note: TikTok can return duplicate results for this search. Sorry about that — it looks like a TikTok-side thing, so we don't have control over it. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Top Search API View Pricing Search TikTok Top results for videos and photo carousels; keyword search returns videos only. TikTok may return duplicate results. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Keyword to search for"},"publish_time":{"type":"string","enum":["yesterday","this-week","this-month","last-3-months","last-6-months","all-time"],"description":"Time Frame TikTok was posted"},"sort_by":{"type":"string","enum":["relevance","most-liked","date-posted"],"description":"Sort by"},"region":{"type":"string","description":"Note, this doesn't filter the tiktoks only in a specfic region, it puts the proxy there. Use it in case you want to scrape posts only available for some country. Use 2 letter country codes like US, GB, FR, etc"},"cursor":{"type":"number","description":"Cursor to get more videos. Get 'cursor' from previous response."}},"required":["query"],"additionalProperties":false},"example":{"query":"funny"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"items":[{"id":"7620673421353012494","desc":"#fyp #dog #funny #humor  #blowthisup?   ","content_type":"multi_photo","create_time":"2026-03-24T04:25:45.000Z","desc_language":"un","region":"US","is_top":0,"statistics":{"aweme_id":"7620673421353012494","collect_count":75335,"comment_count":2555,"digg_count":570679,"download_count":1026,"forward_count":0,"lose_comment_count":0,"lose_count":0,"play_count":2674660,"repost_count":0,"share_count":146329,"whatsapp_share_count":430},"video":{"ai_dynamic_cover":{"data_size":0,"height":814,"uri":"tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f","url_list":["https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f~tplv-photomode-image-cover:640:0:q72.heic?dr=12229&refresh_token=b1c65c7d&x-expires=1777644000&x-signature=%2Fud5EfXS%2Fh0MoLcb%2BlOTtddSxt4%3D&t=5897f7ec&ps=d5b8ac02&shp=d05b14bd&shcp=0e6dc556&idc=useast8&s=SEARCH&biz_tag=tt_photomode&sc=cover"],"url_prefix":null,"width":640},"ai_dynamic_cover_bak":{"data_size":0,"height":814,"uri":"tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f","url_list":["https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f~tplv-photomode-image-cover:640:0:q72.heic?dr=12229&refresh_token=b1c65c7d&x-expires=1777644000&x-signature=%2Fud5EfXS%2Fh0MoLcb%2BlOTtddSxt4%3D&t=5897f7ec&ps=d5b8ac02&shp=d05b14bd&shcp=0e6dc556&idc=useast8&s=SEARCH&biz_tag=tt_photomode&sc=cover"],"url_prefix":null,"width":640},"big_thumbs":[],"bit_rate":[],"bit_rate_audio":[],"cdn_url_expired":0,"cla_info":{"caption_infos":null,"captions_type":0,"creator_edited_caption_id":0,"enable_auto_caption":0,"has_original_audio":0,"hide_original_caption":false,"is_author_dubbing_qualified":false,"no_caption_reason":3,"no_caption_reason_v2":3,"vertical_positions":null},"cover":{"data_size":0,"height":814,"uri":"tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f","url_list":["https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f~tplv-photomode-image-cover:640:0:q72.heic?biz_tag=musically_general.pics_cover&dr=12229&idc=useast8&ps=d5b8ac02&refresh_token=b1c65c7d&s=SEARCH&sc=cover&shcp=0e6dc556&shp=d05b14bd&t=5897f7ec&x-expires=1777644000&x-signature=%2Fud5EfXS%2Fh0MoLcb%2BlOTtddSxt4%3D"],"url_prefix":null,"width":640},"download_addr":{"height":720,"uri":"","url_list":[],"url_prefix":null,"width":720},"duration":0,"dynamic_cover":{"data_size":0,"height":814,"uri":"tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f","url_list":["https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f~tplv-photomode-image-cover:640:0:q72.heic?dr=12229&refresh_token=b1c65c7d&x-expires=1777644000&x-signature=%2Fud5EfXS%2Fh0MoLcb%2BlOTtddSxt4%3D&t=5897f7ec&ps=d5b8ac02&shp=d05b14bd&shcp=0e6dc556&idc=useast8&s=SEARCH&biz_tag=tt_photomode&sc=cover"],"url_prefix":null,"width":640},"has_watermark":false,"height":0,"is_bytevc1":0,"is_callback":false,"meta":"{\"Loudness\":\"-7.8\",\"LoudnessRange\":\"2\",\"LoudnessRangeEnd\":\"-6.9\",\"LoudnessRangeStart\":\"-8.9\",\"MaximumMomentaryLoudness\":\"-5.8\",\"MaximumShortTermLoudness\":\"-6.6\",\"Peak\":\"1\",\"Version\":\"1\",\"VolumeInfoJson\":\"{\\\"LoudnessRangeStart\\\":-8.9,\\\"MaximumMomentaryLoudness\\\":-5.8,\\\"MaximumShortTermLoudness\\\":-6.6,\\\"Loudness\\\":-7.8,\\\"LoudnessRange\\\":2,\\\"LoudnessRangeEnd\\\":-6.9,\\\"Peak\\\":1,\\\"Version\\\":1}\",\"loudness\":\"-7.8\",\"peak\":\"1\"}","need_set_token":false,"origin_cover":{"data_size":0,"height":814,"uri":"tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f","url_list":["https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f~tplv-photomode-image-cover:640:0:q72.heic?dr=12229&refresh_token=b1c65c7d&x-expires=1777644000&x-signature=%2Fud5EfXS%2Fh0MoLcb%2BlOTtddSxt4%3D&t=5897f7ec&ps=d5b8ac02&shp=d05b14bd&shcp=0e6dc556&idc=useast8&s=SEARCH&biz_tag=tt_photomode&sc=cover"],"url_prefix":null,"width":640},"play_addr":{"height":720,"uri":"https://v16m.tiktokcdn-us.com/c7621dcf09b9341fd297a5fde52650eb/69ea3264/video/tos/useast5/tos-useast5-ve-27dcd7c799-tx/oIFNlEJniBUCfwZeDIIhwCIXUBLDbrFQNJMOCy/?a=1233&bti=bmQxZmR2bndsQGo0QHM6OjZAYG1lb2IrbGhxYCMucCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ft=gKfIn8s6ogVP12NvHcWt.IxRNGBO63_45SY&mime_type=audio_mpeg&qs=6&rc=M2Q7ZWg7Omg3NThoZzRpZkBpanlwczQ6ZnY0ZDMzNzU8M0A0MDIyMDYzXmMxNGEyNV4yYSMvbWgycjRnM2tgLS1kMTZzcw%3D%3D&vvpl=1&l=20260416145237BFFC8571A9B23E058740&btag=e000b8000&shp=d05b14bd&shcp=-","url_key":"7110642235061947141","url_list":["https://v16m.tiktokcdn-us.com/c7621dcf09b9341fd297a5fde52650eb/69ea3264/video/tos/useast5/tos-useast5-ve-27dcd7c799-tx/oIFNlEJniBUCfwZeDIIhwCIXUBLDbrFQNJMOCy/?a=1233&bti=bmQxZmR2bndsQGo0QHM6OjZAYG1lb2IrbGhxYCMucCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ft=gKfIn8s6ogVP12NvHcWt.IxRNGBO63_45SY&mime_type=audio_mpeg&qs=6&rc=M2Q7ZWg7Omg3NThoZzRpZkBpanlwczQ6ZnY0ZDMzNzU8M0A0MDIyMDYzXmMxNGEyNV4yYSMvbWgycjRnM2tgLS1kMTZzcw%3D%3D&vvpl=1&l=20260416145237BFFC8571A9B23E058740&btag=e000b8000&shp=d05b14bd&shcp=-"],"url_prefix":null,"width":720},"ratio":"720p","tags":null,"width":0},"author":{"accept_private_policy":false,"account_labels":null,"ad_cover_url":null,"advance_feature_item_order":null,"advanced_feature_info":null,"authority_status":0,"avatar_168x168":{"height":720,"uri":"tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708","url_list":["https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708~tplv-tiktokx-cropcenter:168:168.webp?dr=9638&refresh_token=6a1adba9&x-expires=1776434400&x-signature=RHwVN7IVaYS3wYc93K3Xvt6xHIg%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8"],"url_prefix":null,"width":720},"avatar_300x300":{"height":720,"uri":"tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708","url_list":["https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708~tplv-tiktokx-cropcenter:300:300.webp?dr=9638&refresh_token=59698e3f&x-expires=1776434400&x-signature=IGQFUwoqQ5%2FQs%2BE%2F6IxBe%2Bla%2FMs%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8"],"url_prefix":null,"width":720},"avatar_larger":{"height":720,"uri":"tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708","url_list":["https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708~tplv-tiktokx-cropcenter:1080:1080.webp?dr=9640&refresh_token=071322d1&x-expires=1776434400&x-signature=n6Y%2FOeq3wWDaJErvVXX2deeZ%2BS8%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8"],"url_prefix":null,"width":720},"avatar_medium":{"height":720,"uri":"tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708","url_list":["https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=316847ed&x-expires=1776434400&x-signature=7wRGo7gdVGUeqGWYRh037aNRPsQ%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8"],"url_prefix":null,"width":720},"avatar_thumb":{"height":720,"uri":"tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708","url_list":["https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=musically_general.pics_user_cover&dr=9640&idc=useast8&ps=13740610&refresh_token=17c8dbe7&shcp=34ff8df6&shp=d05b14bd&t=4d5b0474&x-expires=1776434400&x-signature=kMEbPxDChItSQ6ipFx2PmdSKpVw%3D"],"url_prefix":null,"width":720},"avatar_uri":"tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708","aweme_count":0,"bold_fields":null,"can_message_follow_status_list":[2],"can_set_geofencing":null,"cha_list":null,"comment_filter_status":0,"comment_setting":0,"commerce_user_level":0,"cover_url":null,"custom_verify":"","cv_level":"","download_prompt_ts":0,"enabled_filter_all_comments":false,"enterprise_verify_reason":"","events":null,"fake_data_info":{},"fb_expire_time":0,"follow_status":0,"follower_count":1680,"follower_status":0,"followers_detail":null,"following_count":504,"friends_status":0},"images":["https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f~tplv-photomode-image-v1:q70.webp?dr=8793&refresh_token=4f303086&x-expires=1777644000&x-signature=i2s38bIqG87eWf6DIfKDjn5LYMU%3D&t=5897f7ec&ps=b40d0ec8&shp=d05b14bd&shcp=0e6dc556&idc=useast8&s=SEARCH&biz_tag=tt_photomode&sc=image"],"music":{"author":"\uD835\uDC19","duration":16,"id":7110642235061947000,"title":"original sound - al7a.z","play_url":"https://v16m.tiktokcdn-us.com/c7621dcf09b9341fd297a5fde52650eb/69ea3264/video/tos/useast5/tos-useast5-ve-27dcd7c799-tx/oIFNlEJniBUCfwZeDIIhwCIXUBLDbrFQNJMOCy/?a=1233&bti=bmQxZmR2bndsQGo0QHM6OjZAYG1lb2IrbGhxYCMucCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ft=gKfIn8s6ogVP12NvHcWt.IxRNGBO63_45SY&mime_type=audio_mpeg&qs=6&rc=M2Q7ZWg7Omg3NThoZzRpZkBpanlwczQ6ZnY0ZDMzNzU8M0A0MDIyMDYzXmMxNGEyNV4yYSMvbWgycjRnM2tgLS1kMTZzcw%3D%3D&vvpl=1&l=20260416145237BFFC8571A9B23E058740&btag=e000b8000&shp=d05b14bd&shcp=-","matched_song":{"author":"Soulja Boy Tell'em","id":"6732704090041616385","title":"Crank That (Soulja Boy)"}},"is_eligible_for_commission":false,"is_paid_partnership":false,"is_ad":false,"url":"https://www.tiktok.com/@idk_kid712/photo/7620673421353012494","shop_product_url":null}],"cursor":30},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/song":{"post":{"operationId":"social_tiktok_song","x-nexscope-slug":"social-tiktok-song","summary":"TikTok Get Song Details","description":"Fetches detailed metadata for a specific TikTok sound or song by its clipId. Returns `music_info` with `title`, `author`, `album`, `duration`, `user_count` (number of videos using this sound), `play_url`, cover art, and artist details. Use the `clipId` from a sound URL or from the popular songs endpoint. Scraping details from the song detail Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Get Song Details API View Pricing Get details for a TikTok sound or song. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"clipId":{"type":"string","description":"This is a little confusing because this isn't songId like you'd think. It is the clipId. I guess because you can clip different portions of a song \uD83E\uDD37‍♂️"}},"required":["clipId"],"additionalProperties":false},"example":{"clipId":"7439295283975702544"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"music_info":{"album":"Different","allow_offline_music_to_detail_page":false,"artists":[{"avatar":{"uri":"tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848","url_list":["https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848~c5_168x168.webp?lk3s=544a444f&nonce=23330&refresh_token=9e7d26286320fa35b998105f0dcbc158&x-expires=1741053600&x-signature=5oUamOIDpQFqlJS8XBBgEaNiNK0%3D&shp=544a444f&shcp=-"],"url_prefix":null},"enter_type":2,"follow_status":0,"follower_status":0,"handle":"micahtylertok","is_block":false,"is_blocked":false,"is_private_account":false,"is_verified":false,"is_visible":false,"nick_name":"Micah Tyler","sec_uid":"MS4wLjABAAAAEdwuYUJfZcFMddE2j_F7VdBPJ-mFgfmhvS_OEZc_CwP9mgiFLDBlqsJOgEaAaHR5","status":1,"uid":"7086245766293226538"}],"audition_duration":60,"author":"Micah Tyler","author_deleted":false,"author_position":null,"avatar_medium":{"height":720,"uri":"tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848","url_list":["https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848~c5_720x720.webp?lk3s=544a444f&nonce=64063&refresh_token=84290303432aef362a12963995398c8c&x-expires=1741053600&x-signature=VWm%2FJPJZmHRb23mnxnbZIoyMEfY%3D&shp=544a444f&shcp=-"],"url_prefix":null,"width":720},"avatar_thumb":{"height":720,"uri":"tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848","url_list":["https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848~c5_100x100.webp?lk3s=544a444f&nonce=19785&refresh_token=546fc5e384f6934ebcb6a569ae37a54d&x-expires=1741053600&x-signature=q5%2FBVdNQxITSyrSbvd69kij1sRE%3D&shp=544a444f&shcp=-"],"url_prefix":null,"width":720},"binded_challenge_id":0,"can_be_stitched":true,"can_not_reuse":false,"collect_stat":0,"commercial_right_type":3,"cover_large":{"height":720,"uri":"tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb","url_list":["https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb.jpeg"],"url_prefix":null,"width":720},"cover_medium":{"height":720,"uri":"tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb","url_list":["https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb.jpeg"],"url_prefix":null,"width":720},"cover_thumb":{"height":720,"uri":"tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb","url_list":["https://p16-sg.tiktokcdn.com/aweme/100x100/tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb.jpeg"],"url_prefix":null,"width":720},"create_time":1563960621,"dmv_auto_show":false,"duration":60,"duration_high_precision":{"audition_duration_precision":60,"duration_precision":60,"shoot_duration_precision":60,"video_duration_precision":60},"external_song_info":[],"extra":"{\"aed_music_dur\":35.15,\"amplitude_peak\":0.90573657,\"apple_song_id\":1294619219,\"beats\":{\"audio_effect_onset\":\"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/oUAUk8ZzzEAU6HBiB7fAhDsjbAN8yAAEhqQTWg\",\"beats_tracker\":\"https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/oAF3bCnBfkAAUeZDlsqGFACtgETHBYaEAAH5DZ\",\"energy_trace\":\"https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/ow8bhfzzsWgaaEAjQHhEKiABkApQUJA5gyNpRA\",\"merged_beats\":\"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/oUIygAzuEAAhAAHCNWBQEYAfF8HjMRdiUFZshk\"},\"can_read\":true,\"can_reuse\":true,\"erase_type\":0,\"erase_uid\":0,\"from_user_id\":7353023837547873313,\"full_song_beat_info\":{\"bpm\":81},\"full_song_beats\":{\"audio_effect_onset\":\"tos-alisg-v-2774/oEF39BYibIPQZrDAG3AwdhCAEgJo3EWEABPiR\",\"beats_tracker\":\"tos-alisg-v-2774/ogAgAf9gDADnFAitguEi0fIMdBNI2Qtg6AZxRC\",\"energy_trace\":\"tos-alisg-v-2774/o8G0ODdiECCg20AtwAREmDRADEBZgAFgn3BeZf\",\"merged_beats\":\"tos-alisg-v-2774/osZ3PAAxGEI3lBTwCEiGEiBAEWRQrYwQdl7UA\"},\"has_edited\":0,\"is_batch_take_down_music\":false,\"is_ugc_mapping\":false,\"is_used\":0,\"loudness_lufs\":-11.893368,\"music_vid\":\"v10ad6g50000ctcrhlvog65o48qsdm1g\",\"owner_id\":0,\"resource_status\":0,\"review_unshelve_reason\":0,\"reviewed\":0,\"schedule_search_time\":0}","full_song":{"full_song_duration":195,"full_song_duration_precision":195.12,"full_song_id":"6739983931317159937","full_song_play_url":{"uri":"tos-alisg-ve-2774/ok4uNQDaztAMCS5ZA6iiwxBnWrBsBXAMIVfyoN","url_list":["https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/ok4uNQDaztAMCS5ZA6iiwxBnWrBsBXAMIVfyoN"],"url_prefix":null},"full_song_shoot_duration":60,"full_song_shoot_duration_precision":60},"has_commerce_right":false,"id":6717159721276541000,"id_str":"6717159721276540930","is_author_artist":true,"is_commerce_music":true,"is_matched_metadata":false,"is_original":false,"is_original_sound":false,"is_pgc":true,"is_shooting_allow":true,"log_extra":"{\"meta_song_matched_type\":\"pgc\",\"ttm_matched_type\":\"\",\"ttm_track_id\":\"\",\"matched_meta_song_id\":\"\",\"vid\":\"\",\"owner_id\":\"\"}"},"rec_list":[],"similar_music":[],"similar_music_ids":null,"status_code":0,"status_msg":""},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/song/videos":{"post":{"operationId":"social_tiktok_song_videos","x-nexscope-slug":"social-tiktok-song-videos","summary":"TikTok TikToks using Song","description":"Fetches TikTok videos that use a specific sound or song, identified by its clipId. Returns `aweme_list`, an array of video objects each with `aweme_id`, `desc` (caption), `statistics` (play_count, digg_count/likes, comment_count, share_count), `video` info, and `author` details. Paginate with `cursor` from the previous response. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok TikToks using Song API View Pricing Get the TikToks using a song 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"clipId":{"type":"string","description":"This is clipId. Can be found on a url like so: https://www.tiktok.com/music/That%27s-Who-I-Praise-7370375686554782506, where 7370375686554782506 is the clipId"},"cursor":{"type":"number","description":"The cursor to get the next page of results."}},"required":[],"additionalProperties":false},"example":{"clipId":"7439295283975702544"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"aweme_list":[{"added_sound_music_info":{"album":"GNX","allow_offline_music_to_detail_page":false,"artists":[],"audition_duration":59,"author":"Kendrick Lamar & SZA","author_deleted":false,"author_position":null,"binded_challenge_id":0,"can_be_stitched":true,"can_not_reuse":false,"collect_stat":0,"commercial_right_type":3,"cover_large":{"height":720,"uri":"tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA","url_list":["https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA.jpeg"],"url_prefix":null,"width":720},"cover_medium":{"height":720,"uri":"tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA","url_list":["https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA.jpeg"],"url_prefix":null,"width":720},"cover_thumb":{"height":720,"uri":"tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA","url_list":["https://p16-sg.tiktokcdn.com/aweme/100x100/tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA.jpeg"],"url_prefix":null,"width":720},"create_time":1732317312,"dmv_auto_show":false,"duration":59,"duration_high_precision":{"audition_duration_precision":59.037,"duration_precision":59.037,"shoot_duration_precision":59.037,"video_duration_precision":60},"external_song_info":[],"extra":"{\"amplitude_peak\":0.9612427,\"apple_song_id\":1781316886,\"beats\":{\"audio_effect_onset\":\"https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/oc3znOgNABAyAsloQEiaoshBsf9juFtiAWABFE\",\"beats_tracker\":\"https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/o4E7lsAzwoFsgihIzEBBFQAWmigfBsDA3EAvit\",\"energy_trace\":\"https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/oUstzgE1gABiQsBsElBWATjF4miFsoLiPAmhfA\",\"merged_beats\":\"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/oAQAGitIzgAmsKs7BBABBDOoiAgEhEfsFWj9FF\"},\"can_read\":true,\"can_reuse\":true,\"erase_type\":0,\"erase_uid\":0,\"from_user_id\":7350212909039600673,\"full_song_beat_info\":{},\"full_song_beats\":{},\"has_edited\":0,\"is_batch_take_down_music\":false,\"is_ugc_mapping\":false,\"is_used\":0,\"loudness_lufs\":-9.605312,\"music_vid\":\"v10ad6g50000ct0gvh7og65tagjqkldg\",\"owner_id\":0,\"resource_status\":0,\"review_unshelve_reason\":0,\"reviewed\":1,\"schedule_search_time\":0}","has_commerce_right":false,"id":7439295283975703000,"id_str":"7439295283975702544","is_author_artist":false,"is_commerce_music":true,"is_matched_metadata":false,"is_original":false,"is_original_sound":false,"is_pgc":true,"is_play_music":false,"is_shooting_allow":true,"language":"English","log_extra":"{\"meta_song_matched_type\":\"pgc\",\"ttm_matched_type\":\"\",\"ttm_track_id\":\"\",\"matched_meta_song_id\":\"\",\"vid\":\"\",\"owner_id\":\"\"}","lyric_short_position":null},"aigc_info":{"aigc_label_type":0,"created_by_ai":false},"allow_gift":true,"anchors":[{"actions":[],"anchor_strong":null,"caption":"","component_key":"anchor_capcut","description":"CapCut · Video Editor","general_type":1,"icon":{"height":720,"uri":"tiktok-obj/cc_anchor_logo_230222.png","url_list":["https://p77-sg.tiktokcdn.com/tiktok-obj/cc_anchor_logo_230222.png~tplv-tiktokx-origin.image?biz_tag=anchor.capcut&dr=10423&idc=no1a&nonce=10587&ps=933b5bde&refresh_token=ea868bfe485d80c4fb34e71dbd716e98&shcp=d05b14bd&shp=45126217&t=4d5b0474"],"url_prefix":null,"width":720},"id":"0","keyword":"CapCut · 2024 in 43 photos","log_extra":"{\"anchor_id\":0,\"anchor_name\":\"CapCut · 2024 in 43 photos\",\"anchor_name_type\":\"template_1\",\"anchor_title_detail\":\"None\",\"anchor_type\":\"TT_CAPCUT\",\"capability_key\":\"none\",\"cc_template_pay_type\":0,\"if_device_language\":\"1\",\"if_race_trigger\":0,\"is_two_line\":0,\"maker_source\":\"\",\"template_id\":\"7439087471498956085\",\"tutorial_id\":\"none\",\"viamaker_anchor_capability_key_weight\":1,\"viamaker_anchor_style_idx\":-1,\"viamaker_anchor_style_source\":3,\"video_source\":1,\"video_type_id\":2}","schema":"aweme://lynxview/?bundle=landing%2Ftemplate.js&channel=tiktok_capcut_anchor_landing_page&container_bg_color=000000&download_optimization=1&dynamic=3&enable_prefetch=1&experiment_70720234=1&experiment_70734729=1&experiment_71198425=1&experiment_71270528=1&experiment_71390981=1&experiment_71540222=1&experiment_71560892=1&experiment_71642885=1&experiment_71790668=1&experiment_71860799=1&experiment_71861046=1&experiment_72275089=1&experiment_72378366=1&experiment_72683638=1&experiment_72995772=1&experiment_73137025=1&experiment_73358472=1&hide_nav_bar=1&hide_status_bar=1&loading_bg_color=000000&onelink=https%3A%2F%2Fttanchor.onelink.me%2FVQBU%2FTiktokAnchorTemplate1&theme=dark&trans_status_bar=1&use_forest=1&use_new_deep_link_func=1&use_spark=1&group_id=7452069943757114646&template_id=7439087471498956085&server_common_log={\"anchor_name_type\":\"template_0\",\"anchor_title_detail\":\"None\",\"if_device_language\":\"1\",\"is_two_line\":0}&export_paid_template=0&music_id=7439295283975702544&music_begin_time=17548&landing_page_style_id=0&is_recommend_ctrl=false&viamaker_anchor_style_source=4&anchor_title_id=0&viamaker_anchor_style_idx=-1&viamaker_anchor_capability_key_weight=1&fans_num=0&show_recruit=0&btn_text=Use template in CapCut&trans_status_bar=1&hide_status_bar=1&channel_type=1&cc_anchor_type=2&default_strategy=2&target_item_list=[{\"item_id\":\"7439087471498956085\",\"item_type\":1,\"tt_item_id\":7452069943757114646,\"tt_item_id_str\":\"7452069943757114646\",\"capability_rec_info\":{\"style_id\":0,\"anchor_title_id\":0,\"is_rec_ctrl\":false,\"viamaker_anchor_style_source\":3}}]&landing_page_style=1&landing_page_timeout=10&surl=https%3A%2F%2Flf-main-gecko-source.tiktokcdn.com%2Fobj%2Ftiktok-teko-source-sg%2F10%2Fgecko%2Fresource%2Ftiktok_capcut_anchor_landing_page%2Flanding%2Ftemplate.js","thumbnail":{"height":64,"uri":"tiktok-obj/64x_Capcut3x.png","url_list":["https://p77-sg.tiktokcdn.com/tiktok-obj/64x_Capcut3x.png~tplv-tiktokx-origin.image?dr=10423&nonce=77923&refresh_token=77b96e44e22e72876d95216d492cac0d&idc=no1a&ps=933b5bde&shcp=d05b14bd&shp=45126217&t=4d5b0474"],"url_prefix":null,"width":64},"type":54}],"anchors_extras":"","animated_image_info":{"effect":0,"type":0},"author":{"ad_cover_url":null,"authority_status":0,"avatar_168x168":{"height":720,"uri":"tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5","url_list":["https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&nonce=23496&ps=87d6e48a&refresh_token=00c6e144ba14a3929bba66f8d4eeb95c&s=MUSIC_AWEME&sc=avatar&shcp=f6441914&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_300x300":{"height":720,"uri":"tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5","url_list":["https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&idc=no1a&nonce=71045&ps=87d6e48a&refresh_token=e1a2307775247b3cbcbb4c405a3dd051&s=MUSIC_AWEME&sc=avatar&shcp=f6441914&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_larger":{"height":720,"uri":"tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5","url_list":["https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&nonce=740&ps=87d6e48a&refresh_token=eec1741aa128547d6c4408853e59ba16&s=MUSIC_AWEME&sc=avatar&shcp=f6441914&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_medium":{"height":720,"uri":"tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5","url_list":["https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&nonce=98842&ps=87d6e48a&refresh_token=c9ced2e139cbb90b75fe4222b231bfb1&s=MUSIC_AWEME&sc=avatar&shcp=f6441914&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"avatar_thumb":{"height":720,"uri":"tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5","url_list":["https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606&idc=no1a&nonce=29842&ps=87d6e48a&refresh_token=31964afe9e3aaab0ed796eece3c31b1b&s=MUSIC_AWEME&sc=avatar&shcp=f6441914&shp=45126217&t=223449c4"],"url_prefix":null,"width":720},"cha_list":null,"comment_filter_status":1,"comment_setting":0,"commerce_user_level":0,"cover_url":[],"custom_verify":"","download_setting":3,"duet_setting":0,"enabled_filter_all_comments":false,"enterprise_verify_reason":"","follow_status":0,"follower_status":0,"followers_detail":null,"friends_status":0,"is_ad_fake":false,"is_block":false,"is_discipline_member":false,"is_star":false,"language":"es","nickname":"El rey de las bromas oficial","prevent_download":false,"region":"MX","relative_users":null,"room_id":0,"sec_uid":"MS4wLjABAAAAbhqboEW5Qk6emunyGrRmD04w52fJAPvOI8XPuGxq9xwnkN9ID8cpxME-yUqEwaYU","share_info":{"now_invitation_card_image_urls":null,"share_desc":"","share_desc_info":"","share_qrcode_url":{"height":720,"uri":"","url_list":[],"url_prefix":null,"width":720},"share_title":"","share_title_myself":"","share_title_other":"","share_url":""},"short_id":"0","signature":"Sigan a mi editor y les mando un saludo ⬇️⬇️⬇️"},"author_user_id":7431412724132922000,"aweme_acl":{"download_general":{"code":1,"extra":"101","mute":false,"show_type":0,"transcode":1},"download_mask_panel":{"code":1,"extra":"101","mute":false,"show_type":0,"transcode":1},"platform_list":null,"press_action_list":null,"share_action_list":null,"share_general":{"code":1,"extra":"101","mute":false,"show_type":1,"toast_msg":"This action isn’t allowed for this post","transcode":1},"share_list_status":0},"aweme_id":"7452069943757114646","aweme_type":0,"banners":null,"behind_the_song_music_ids":null,"behind_the_song_video_music_ids":null,"bodydance_score":0,"branded_content_accounts":null,"cc_template_info":{"author_name":"","clip_count":0,"desc":"","duration_milliseconds":0,"match_type":"top_item","music_copyright":true,"onelink":"https://capcut-yt.onelink.me/W3Oy/mpy6xee2","related_music_id":"","schema_extra":"{\"experiment_id\":\"72683638\"}","style_type":1,"template_id":"7439087471498956085"},"cha_list":[{"author":{"account_labels":null,"ad_cover_url":null,"advance_feature_item_order":null,"advanced_feature_info":null,"bold_fields":null,"can_message_follow_status_list":null,"can_set_geofencing":null,"cha_list":null,"cover_url":null,"events":null,"followers_detail":null,"geofencing":null,"homepage_bottom_toast":null,"item_list":null,"mutual_relation_avatars":null,"need_points":null,"platform_sync_info":null,"relative_users":null,"search_highlight":null,"shield_edit_field_info":null,"type_label":null,"user_profile_guide":null,"user_tags":null,"white_cover_url":null},"banner_list":null,"cha_attrs":null,"cha_name":"memestiktok","cid":"1615484249350165","collect_stat":0,"connect_music":[],"desc":"¡Llegaste al lugar indicado para encontrar memazos! \n\nCada viernes podrás encontrar a los 9 #MEMESTikTok oficiales de la semana.","extra_attr":{"is_live":false},"hashtag_profile":"musically-maliva-obj/422f2c33d377dddff0f11cb5a276196f","is_challenge":0,"is_commerce":false,"is_pgcshow":false,"schema":"aweme://aweme/challenge/detail?cid=1615484249350165","search_highlight":null,"share_info":{"bool_persist":0,"now_invitation_card_image_urls":null,"share_desc":"Check out #memestiktok on TikTok!","share_desc_info":"Check out #memestiktok on TikTok!","share_quote":"","share_signature_desc":"","share_signature_url":"","share_title":"It is a becoming a big trend on TikTok now! Click here: memestiktok","share_title_myself":"","share_title_other":"","share_url":"https://www.tiktok.com/tag/memestiktok?_r=1&name=memestiktok&u_code=ed95h8gmi905eb&_d=ed95ee344m3h4g&share_challenge_id=1615484249350165&sharer_language=en&source=h5_m"},"show_items":null,"sub_type":0,"type":1,"use_count":0,"user_count":0,"view_count":0}],"challenge_position":null,"cmt_swt":false,"collect_stat":0,"comment_config":{"comment_panel_show_tab_config":null,"emoji_recommend_list":null,"long_press_recommend_list":null,"preload":{"preds":"{\"item_post_comment\":0.00011830986683832393}"},"quick_comment":{"enabled":true},"quick_comment_emoji_recommend_list":null},"commerce_config_data":null,"commerce_info":{"adv_promotable":true,"auction_ad_invited":false,"branded_content_type":0,"with_comment_filter_words":false},"content_desc":"","content_desc_extra":[],"content_model":{"custom_biz":{"aweme_trace":"202502180605264FFF1CE5D6043F4CF934"},"standard_biz":{"e_commerce":{"ttec_content_tag":{"recommendation_tag_consumer_str":"","recommendation_tag_creator_str":""}},"tts_voice_info":{"tts_voice_attr":"[]","tts_voice_reuse_params":""},"vc_filter_info":{"vc_filter_attr":"[]"}}},"content_original_type":1,"content_size_type":1,"content_type":"video","cover_labels":null,"create_time":1735070246,"creation_info":{"creation_used_functions":["select_music"]},"desc":"2024 en 43 fotos el rey de las bromas #memestiktok #elreydelasbromas #bromita #pepe #reto #grillo #racha #fotos #luther #2024 #2025 ","desc_language":"es"}],"can_pin_video":false,"cursor":12,"extra":{"fatal_item_ids":[],"logid":"202502180605264FFF1CE5D6043F4CF934","now":1739829927000},"has_more":1,"log_pb":{"impr_id":"202502180605264FFF1CE5D6043F4CF934"},"need_lazy_loading":false,"status_code":0,"status_msg":""},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/get-trending-feed":{"post":{"operationId":"social_tiktok_get_trending_feed","x-nexscope-slug":"social-tiktok-get-trending-feed","summary":"TikTok Trending Feed","description":"Fetches TikTok's trending/For You feed for a given region — useful for discovering viral content and what's currently popular. Returns `aweme_list`, an array of video objects each with `aweme_id`, `desc` (caption), `statistics` (play_count, digg_count/likes, comment_count, share_count, collect_count), `video` (playback and download URLs, cover), `author` info, and `image_post_info` for photo carousels. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Trending Feed API View Pricing Get the trending feed from TikTok. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string","description":"Where you want the proxy to be. This doesn't mean that you will only see TikToks from this region, you will just see the content that isn't banned in that region."},"trim":{"type":"boolean","description":"Set to true to get a trimmed response."}},"required":["region"],"additionalProperties":false},"example":{"region":"US"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok","data":{"success":true,"aweme_list":[{"aweme_id":"7540000301621841183","desc":"#hudsonvalley #fallgetaway #farm #upstateny #resort ","desc_language":"un","region":"US","statistics":{"aweme_id":"7540000301621841183","comment_count":646,"digg_count":71423,"download_count":130,"play_count":1443873,"share_count":8440,"forward_count":0,"lose_count":0,"lose_comment_count":0,"whatsapp_share_count":37,"collect_count":21957,"repost_count":0},"video":{"play_addr":{"uri":"https://v16m.tiktokcdn-us.com/55f0fa91eb07f93e6cc97b69cf44bd28/68b782c0/video/tos/useast5/tos-useast5-ve-27dcd7c799-tx/ocTKSt6SBoLEzYiMEvPhB7Ak7g1fI9ZDxCOqp8/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=124&bt=62&ft=arR-Iq4fmbdPD1250i5T3wUk~i~AMeF~O5&mime_type=audio_mpeg&qs=3&rc=NTQ3O2hnOzo1NjU6NGRoaUBpMzV2M2k6ZnduaDMzNzU8M0AvMy8yMzVeNjIxNC9hYjQvYSM2L3FpcjRvYmtgLS1kMTZzcw%3D%3D&vvpl=1&l=20250826234818FC500F9F5A67BF1C488E&btag=e00088000&shp=d05b14bd&shcp=-","url_list":["https://v16m.tiktokcdn-us.com/55f0fa91eb07f93e6cc97b69cf44bd28/68b782c0/video/tos/useast5/tos-useast5-ve-27dcd7c799-tx/ocTKSt6SBoLEzYiMEvPhB7Ak7g1fI9ZDxCOqp8/?a=1233&bti=OHYpOTY0Zik3OjlmOm01MzE6ZDQ0MDo%3D&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=124&bt=62&ft=arR-Iq4fmbdPD1250i5T3wUk~i~AMeF~O5&mime_type=audio_mpeg&qs=3&rc=NTQ3O2hnOzo1NjU6NGRoaUBpMzV2M2k6ZnduaDMzNzU8M0AvMy8yMzVeNjIxNC9hYjQvYSM2L3FpcjRvYmtgLS1kMTZzcw%3D%3D&vvpl=1&l=20250826234818FC500F9F5A67BF1C488E&btag=e00088000&shp=d05b14bd&shcp=-"],"width":720,"height":720,"url_key":"7183038472843692805","url_prefix":null},"cover":{"uri":"tos-useast8-i-photomode-tx2/3a1c4f9217414c3c95dd8d25c2dd8d13","url_list":["https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-i-photomode-tx2/3a1c4f9217414c3c95dd8d25c2dd8d13~tplv-photomode-image-cover:640:0:q70.webp?dr=12229&refresh_token=df32aa50&x-expires=1757545200&x-signature=zurwCGa5E9ieLV%2FaQHxx19%2FvpJY%3D&t=5897f7ec&ps=d5b8ac02&shp=d05b14bd&shcp=1a816805&idc=useast5&s=FEED&biz_tag=tt_photomode&sc=cover"],"width":640,"height":853,"url_prefix":null}},"image_post_info":{"images":[{"display_image":{"uri":"tos-useast8-i-photomode-tx2/3a1c4f9217414c3c95dd8d25c2dd8d13","url_list":["https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-i-photomode-tx2/3a1c4f9217414c3c95dd8d25c2dd8d13~tplv-photomode-sr-vqe2:1080:0:1080:0:q75.webp?dr=10952&refresh_token=0efd0e37&x-expires=1757545200&x-signature=uEKcmDy5CeI9%2BCTYKvVleyhFFfc%3D&t=5897f7ec&ps=28cf8ac7&shp=d05b14bd&shcp=1a816805&idc=useast5&s=FEED&biz_tag=tt_photomode&sc=image"],"width":1080,"height":1440,"url_prefix":null,"preview":{"data":"JjKsVpu2lacDqKQTr3r1vbQ7nneyl2DbRtqwiB1yKd5VaJpmb0K22irPkmincCSdbct0FZ9/ZuVzCDitAaVMzAs1atvBHHGEfBrweW2x7HMcpbTywjY4OavwmSTDHpW02n2ztuIFJLZpsxHWqqTS0Zk4RfQgQIEGaKqyRzo2ADiitPrbRj9XRtyE7TiqDl93etHFNMantWB0FAFz61PCHzk1PsUdqUDFMBdqnqKKXNFKyAKKKKAENAoooASiiimB/9k=","preview_type":2,"meta_key":""}}}],"title":"The most perfect fall getaway for the day or the night! \uD83C\uDF42","post_extra":"{\"photo_cover_shrink\":false,\"photo_blurhash\":false,\"photo_progressive\":false}"},"author":{"uid":"6754760670083138566","short_id":"0","nickname":"Bre \uD83E\uDD0D","signature":"3rd grade teacher \uD83C\uDF4E| making life cute \uD83E\uDE9E| home inspo loading… \uD83C\uDFE1\uD83E\uDD0E”","avatar_thumb":{"uri":"tos-useast8-avt-0068-tx2/3bc038986117debaa55c18bae5685e18","url_list":["https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/3bc038986117debaa55c18bae5685e18~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=8835&idc=useast5&ps=87d6e48a&refresh_token=22f3402b&s=FEED&sc=avatar&shcp=1a816805&shp=d05b14bd&t=223449c4&x-expires=1756335600&x-signature=vQBsMRRY5xPAgpNt%2F6JchCzoVDE%3D"],"width":720,"height":720,"url_prefix":null},"avatar_medium":{"uri":"tos-useast8-avt-0068-tx2/3bc038986117debaa55c18bae5685e18","url_list":["https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/3bc038986117debaa55c18bae5685e18~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=8836&idc=useast5&ps=87d6e48a&refresh_token=93846dfc&s=FEED&sc=avatar&shcp=1a816805&shp=d05b14bd&t=223449c4&x-expires=1756335600&x-signature=y49Gf4w80feFtWOJCykL7x2c20Q%3D"],"width":720,"height":720,"url_prefix":null},"region":"US","language":"en","sec_uid":"MS4wLjABAAAANbZGXVN-iwJvesiIVGgD_nRTpyI4PGOXHEbt01cN9U5S3Ih21qUe5WQ9ztsn2J6h","social_info":"{\"imprs_info\":\"vv_100k+\",\"is_cold_info\":\"0\"}","events":null},"create_time":1755543133,"is_ad":false,"is_eligible_for_commission":false,"create_time_utc":"2025-08-18T18:52:13.000Z","url":"https://www.tiktok.com/@breannafriedman0/photo/7540000301621841183"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/shop/search":{"post":{"operationId":"social_tiktok_shop_search","x-nexscope-slug":"social-tiktok-shop-search","summary":"TikTok Shop Shop Search","description":"Searches TikTok Shop for products matching a keyword query. Returns an array of product objects each with `title`, `cover` image, `url` (product page link), `price`, `sold_count`, `review_count`, `rating`, and `shop_name`. Paginate with `page`; filter by region. Scrape TikTok Shop Products from a search! Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Shop Shop Search API View Pricing Search TikTok Shop products by keyword. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Term you want to search for"},"region":{"type":"string","enum":["US","GB","DE","FR","IT","ID","MY","MX","PH","SG","ES","TH","VN","BR","JP","IE"],"description":"Region to search shop products in. Non-US TikTok Shop regions are not reliable right now and may return limited or inconsistent results. Sorry for the inconvenience."},"page":{"type":"number","description":"Page number to retrieve"}},"required":["query"],"additionalProperties":false},"example":{"query":"shoes"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok-shop","data":{"success":true,"query":"shoes","total_products":100,"products":[{"product_id":"1730213444857467838","title":"Crocs Adult Classic Clogs","image":{"height":1200,"width":1200,"uri":"tos-useast5-i-omjb5zjo8w-tx/b16ea2605a0d4708af7cbc3a1dd03624","url_list":["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/b16ea2605a0d4708af7cbc3a1dd03624~tplv-fhlh96nyum-crop-webp:1200:1200.webp?dr=12190&from=2378011839&idc=useast5&ps=933b5bde&shcp=a6e80448&shp=8dbd94bf&t=555f072d"]},"product_price_info":{"sku_id":"1730213454432146366","symbol_position":1,"show_currency_space":false,"currency_show_mode":1,"currency_name":"USD","currency_symbol":"$","sale_price_decimal":"49.99","sale_price_format":"49.99","single_product_price_format":"49.99","single_product_price_decimal":"49.99","sale_price_integer_part_format":"49","sale_price_decimal_part_format":"99","decimal_point_symbol":".","promotion_deduction_details":{}},"rate_info":{"score":4.8,"review_count":"2493"},"sold_info":{"sold_count":24737},"seller_info":{"seller_id":"7495832567110863806","shop_name":"Crocs","shop_logo":{"height":300,"width":300,"uri":"tos-useast5-i-omjb5zjo8w-tx/0e1e83bcdab948b9aa9e6474e87a8a80","url_list":["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/0e1e83bcdab948b9aa9e6474e87a8a80~tplv-fhlh96nyum-resize-png:300:300.png?dr=12184&from=2422056039&idc=useast5&ps=933b5bde&shcp=d9d491bf&shp=905da467&t=555f072d"]}},"seo_url":{"updated_at":"1754122673333","canonical_url":"https://www.tiktok.com/shop/pdp/classic-clogs-by-crocs-lightweight-slip-on-shoes-with-ventilation/1730213444857467838","slug":"classic-clogs-by-crocs-lightweight-slip-on-shoes-with-ventilation","type":2,"version":2}}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/shop/products":{"post":{"operationId":"social_tiktok_shop_products","x-nexscope-slug":"social-tiktok-shop-products","summary":"TikTok Shop Shop Products","description":"Lists all products from a specific TikTok Shop store by its URL. Returns an array of product objects each with `title`, `cover` images, `url`, `price` info, `sold_count`, `review_count`, and `rating`. Paginate with `cursor` from the previous response; filter by region; use `sort_by=top` for best-selling products or `sort_by=new_releases` for newest products. Non-US shop catalog coverage depends on TikTok exposing that shop in the selected region, so some shops can return `not_found` outside the US even when they appear in shop search. Get the products from a TikTok Shop. This endpoint costs 1 credit per request. Use the cursor from the response to paginate through results. Non-US shop catalog coverage depends on TikTok exposing that shop in the selected region. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Shop Shop Products API View Pricing Get products from a TikTok Shop for 1 credit per request. Paginate with cursor. Non-US catalog availability depends on the selected region. 1 credit per request\nLists all products from a specific TikTok Shop store by its URL. Returns an array of product objects each with `title`, `cover` images, `url`, `price` info, `sold_count`, `review_count`, and `rating`. Paginate with `cursor` from the previous response; filter by region; use `sort_by=top` for best-selling products or `sort_by=new_releases` for newest products. Non-US shop catalog coverage depends on TikTok exposing that shop in the selected region, so some shops can return `not_found` outside the US even when they appear in shop search. Get the products from a TikTok Shop. This endpoint costs 1 credit per request. Use the cursor from the response to paginate through results. Non-US shop catalog coverage depends on TikTok exposing that shop in the selected region.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The TikTok Shop store URL."},"sort_by":{"type":"string","enum":["top","new_releases"],"description":"Sort products by best-selling items (`top`) or newest products (`new_releases`). Defaults to `top`."},"region":{"type":"string","enum":["US","GB","DE","FR","IT","ID","MY","MX","PH","SG","ES","TH","VN","BR","JP","IE"],"description":"Region to get shop products from. Defaults to US if not provided. Non-US regions are not reliable right now and may return `not_found` or limited catalog data even when the shop appears in search. Sorry for the inconvenience."},"cursor":{"type":"string","description":"Cursor parameter from the previous response to retrieve the next page of products. Omit for the first page."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok-shop","data":{"success":true,"shopInfo":{"seller_id":"7495794203056835079","sold_count":3767605,"on_sell_product_count":36,"review_count":284185,"global_seller_id":"7495794203056835079","global_sold_count":"3767605","followers_count":"237879","video_count":"2413","enable_follow":true,"shop_name":"Goli Nutrition","shop_logo":{"height":300,"width":300,"uri":"tos-useast5-i-omjb5zjo8w-tx/e7478d3e93d4487a9e772fa74e10f506","url_list":["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e7478d3e93d4487a9e772fa74e10f506~tplv-fhlh96nyum-resize-webp:300:300.webp?dr=12185&from=2422056039&idc=useast8&ps=933b5bde&shcp=a6e80448&shp=905da467&t=555f072d"]},"shop_rating":"4.6","shop_link":"https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079","format_sold_count":"3.7M","region":"US","display_on_sell_product_count":"36","format_global_sold_count":"3.7M","shop_slogan":"Health Simple✨\nVegan. Gluten-Free. Non-GMO.","format_followers_count":"237.8K+","format_video_count":"2413","store_sub_score":[{"score":0.9967,"type":1,"score_percentage":"100","high_light_tag":1,"platform_rate_type":1}],"worst_rating":"0","best_rating":"5","creator_name":"Goli® Nutrition","desc":"Shop Goli Nutrition on TikTok Shop! 3.7M sold, 237.8K+ followers. 89+% positive feedback. 50+% Ships in 48h, 100% replies in 24h. Join the trend!"},"products":[{"product_id":"1729527313880355335","title":"Goli Ashwagandha & Vitamin D Gummy - Mixed Berry, KSM-66, Vegan, Plant Based, Non-GMO, Gluten-Free & Gelatin Free. America's #1 Ashwagandha Brand","image":{"height":1500,"width":1500,"uri":"tos-useast5-i-omjb5zjo8w-tx/30fc1338a2bf474a9d252a790e4c119f","url_list":["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/30fc1338a2bf474a9d252a790e4c119f~tplv-fhlh96nyum-crop-webp:1500:1500.webp?dr=12190&from=2378011839&idc=useast8&ps=933b5bde&shcp=905da467&shp=8dbd94bf&t=555f072d"]},"product_price_info":{"sku_id":"1729527298861535751","symbol_position":1,"show_currency_space":false,"currency_show_mode":1,"currency_name":"USD","currency_symbol":"$","sale_price_decimal":"14.96","origin_price_decimal":"24.99","sale_price_format":"14.96","origin_price_format":"24.99","discount_format":"40%","discount_decimal":"0.4","reduce_price_format":"Saving $10.03","single_product_price_format":"14.96","single_product_price_decimal":"14.96","sale_price_integer_part_format":"14","sale_price_decimal_part_format":"96","decimal_point_symbol":".","promotion_deduction_details":{"seller_subtotal_deduction":"10.03","seller_subtotal_deduction_decimal":"10.03"}},"rate_info":{"score":4.5,"review_count":"91316"},"sold_info":{"sold_count":1235089},"seller_info":{"seller_id":"7495794203056835079","shop_name":"Goli Nutrition","shop_logo":{"height":300,"width":300,"uri":"tos-useast5-i-omjb5zjo8w-tx/e7478d3e93d4487a9e772fa74e10f506","url_list":["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e7478d3e93d4487a9e772fa74e10f506~tplv-fhlh96nyum-resize-png:300:300.png?dr=12184&from=2422056039&idc=useast8&ps=933b5bde&shcp=d9d491bf&shp=905da467&t=555f072d"]}},"seo_url":{"updated_at":"1754035613102","canonical_url":"https://www.tiktok.com/shop/pdp/ashwagandha-gummies-by-goli-ksm-66-mixed-berry-vegan-non-gmo/1729527313880355335","slug":"ashwagandha-gummies-by-goli-ksm-66-mixed-berry-vegan-non-gmo","type":2,"version":2}}],"has_more":true,"cursor":"WzExMzg1LCIxNzMxMDMxNzc2NDk3MDc4NzkxIl0="},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/product":{"post":{"operationId":"social_tiktok_product","x-nexscope-slug":"social-tiktok-product","summary":"TikTok Shop Product Details","description":"Fetches full details for a specific US TikTok Shop product by its URL, including stock levels and affiliate videos. Returns `product_info` with `product_base` (title, images, sold_count, price), `skus` (variants with exact `stock` counts plus TikTok's `sku_name` and `gtin` when available), and `product_detail_review` (product_rating, review_count, sample reviews). `gtin` contains `gtin_type` and `gtin_code`, or is null when TikTok does not provide a barcode. The response also includes `shop_info` (shop_name, shop_rating, followers_count) and `related_videos` (affiliate TikToks promoting the product). This endpoint currently supports the US region only. Get the details of a TikTok Shop Product. This endpoint currently supports US TikTok Shop products only. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Shop Product Details API View Pricing Get details for a TikTok Shop product. US products only. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the product to get details for."},"region":{"type":"string","description":"Region for the product details request. US is the reliable region right now; non-US regions should not be considered reliable and may return `bad_request` or missing product data. Sorry for the inconvenience."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.tiktok.com/shop/pdp/goli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo/1729587769570529799"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok-shop","data":{"success":true,"categories":[{"category_id":"601450","level":1,"is_leaf":false,"parent_id":"0","category_name":"Beauty & Personal Care","name_key":"magellan_601450"}],"sale_region":"US","error_code":0,"error_message":"","product_info":{"product_id":"1730383241618035288","status":1,"seller":{"seller_id":"7496021452055022168","name":"Manspot","avatar":{"height":300,"width":300,"uri":"tos-useast5-i-omjb5zjo8w-tx/c34696c75ae64397911e2e06193a12cc","url_list":["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c34696c75ae64397911e2e06193a12cc~tplv-fhlh96nyum-resize-png:300:300.png?dr=0&from=2422056039&idc=useast8&ps=933b5bde&shcp=6ce186a1&shp=905da467&t=555f072d"]},"product_count":14,"seller_location":"United States of America","tiktok_id":"7098283607022158891","tiktok_url":"https://www.tiktok.com/@7098283607022158891"},"product_base":{"title":"【dealsforyoudays】Manspot Electric Body Hair Razor for Men - USB Rechargeable, Waterproof, Replaceable Ceramic Heads, Ultra-Smooth Shaving, Cordless Trimmer for Grooming Routine","desc_video":{"id":"v12d52gd0030ctp3lknog65q8llkgcng","duration":45.12,"post_url":"https://p16-sign.tiktokcdn-us.com/tos-useast5-p-afa798-tx/o8ZA1q3RIWBxiuEE26yRtg6vSIOIwvi4uUM0S~tplv-noop.image?t=9276707c&x-expires=1754373510&x-signature=MsmTJcnrIme3jsFlNSt2inH%2FpJQ%3D","media_type":"video","video_infos":[{"main_url":"https://v16m-default.tiktokcdn-us.com/01ffc8343c2e3127afb0726eff95ad96/68919d86/video/tos/useast5/tos-useast5-v-afa798-tx/owOtyWSdi4731vMSvI96iQRMUyvIwE0IgZBC6/?a=0&bti=PDM8QDI2M2A%3D&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=832&bt=416&cs=0&ds=6&ft=GS-jnInz7Th6_-fKXq8Zmo&mime_type=video_mp4&qs=0&rc=ZTtnNTlkaDdkNTM6MzQ0M0BpamZub3Q5cm42dzMzZzVnNEAtYjRgNDY2Xi4xYl5eMWIwYSNrZGk1MmRraW1gMC1kMi9zcw%3D%3D&vvpl=1&l=202508042357441758B7D2E7DB9E01F44C&btag=e00088000","backup_url":"https://v16m-default.tiktokcdn-us.com/01ffc8343c2e3127afb0726eff95ad96/68919d86/video/tos/useast5/tos-useast5-v-afa798-tx/owOtyWSdi4731vMSvI96iQRMUyvIwE0IgZBC6/?a=0&bti=PDM8QDI2M2A%3D&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=832&bt=416&cs=0&ds=6&ft=GS-jnInz7Th6_-fKXq8Zmo&mime_type=video_mp4&qs=0&rc=ZTtnNTlkaDdkNTM6MzQ0M0BpamZub3Q5cm42dzMzZzVnNEAtYjRgNDY2Xi4xYl5eMWIwYSNrZGk1MmRraW1gMC1kMi9zcw%3D%3D&vvpl=1&l=202508042357441758B7D2E7DB9E01F44C&btag=e00088000","url_expire":1754373510,"width":1024,"height":576,"file_hash":"19737dc9ddb53c96371d9bb7c79fd1fd","format":"mp4","size":2408193,"bitrate":426984,"video_quality":"normal"}]},"images":[{"height":800,"width":800,"thumb_uri":"tos-useast5-i-omjb5zjo8w-tx/23a77319ea594151b3730747704a62bc","thumb_url_list":["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/23a77319ea594151b3730747704a62bc~tplv-fhlh96nyum-resize-jpeg:200:200.jpeg?dr=0&t=555f072d&ps=933b5bde&shp=6ce186a1&shcp=607f11de&idc=useast8&from=1826719393"],"uri":"tos-useast5-i-omjb5zjo8w-tx/23a77319ea594151b3730747704a62bc","url_list":["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/23a77319ea594151b3730747704a62bc~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg?dr=0&t=555f072d&ps=933b5bde&shp=6ce186a1&shcp=607f11de&idc=useast8&from=1826719393"]}],"sold_count":7160,"price":{"original_price":"$3?","real_price":"$2?","discount":"-47%","need_icon":false,"is_interval_price":false,"show_hot_zone":false,"min_sku_price":"2?","max_sku_price":"","currency":"USD","min_sku_original_price":"39.99","panel_schema":"","currency_symbol":"$","symbol_position":1,"da_info":"{\"price_show_tag\":\"\",\"discount_percentage\":\"47\"}"}},"sale_props":[{"prop_id":"100000","prop_name":"Color","has_image":true,"sale_prop_values":[{"prop_value_id":"6926865445131749121","prop_value":"Black","image":{"height":800,"width":800,"thumb_uri":"tos-useast5-i-omjb5zjo8w-tx/93a076a4750d48bdafea2ae357725093","thumb_url_list":["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/93a076a4750d48bdafea2ae357725093~tplv-fhlh96nyum-resize-jpeg:200:200.jpeg?dr=0&t=555f072d&ps=933b5bde&shp=6ce186a1&shcp=607f11de&idc=useast8&from=1826719393"],"uri":"tos-useast5-i-omjb5zjo8w-tx/93a076a4750d48bdafea2ae357725093","url_list":["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/93a076a4750d48bdafea2ae357725093~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg?dr=0&t=555f072d&ps=933b5bde&shp=6ce186a1&shcp=607f11de&idc=useast8&from=1826719393"]}}]}],"skus":[{"sku_id":"1730384306561520216","sku_name":null,"gtin":null,"sku_sale_props":[{"prop_id":"100000","prop_name":"Color","prop_value_id":"6926865445131749121","prop_value":"Black"}],"sale_prop_value_ids":"6926865445131749121","stock":1824,"purchase_limit":20,"price":{"real_price":{"price_str":"$2?","price_val":"2?","currency":"USD","original_price":""},"original_price":"$3?","discount":"-47%","original_price_value":"3?"},"need_icon":false,"add_to_cart_button":{"status":2},"warehouse_id":"7348468937296889643","quantity_property":{"default_add_cart_quantity":1,"quantity_minus_support_edit":true},"buy_button":{"desc":"Buy now","default_desc":"Buy now"},"minimum_buy_quantity":0,"promotion_limit_quantity":0,"deduction_text":"","status":1,"pdp_button_area_id":"add_disable","da_info":"{\"delivery_flag_sku\":\"{\\\"free_shipping_product_cnt\\\":\\\"-1\\\"}\"}"}],"product_detail_review":{"product_rating":4.3,"review_count":595,"review_items":[{"review":{"review_id":"7516224145770006315","rating":5,"display_text":"Great product. Good shipping. Exactly as described. Does not nick. Holds charge for a long time. Light weight. Waterproof even used in the shower.","review_timestamp":"1750007337100","has_origin_text":true,"display_review_text":[{"text_type":1,"plain_text":"Great product. Good shipping. Exactly as described. Does not nick. Holds charge for a long time. Light weight. Waterproof even used in the shower."}],"review_timestamp_fmt":"June 15, 2025","main_review_title":""},"sku_id":"1730384306561651288","sku_specification":"Item: Blue","review_user":{"name":"thedustinppeterson","avatar":{"url_list":["https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/98315574440f18f07c635207bb216368~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=45b1ac87&x-expires=1754521200&x-signature=Ur3y7f80YCwLVfIEmYaxTbAxuyE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=5f8d3399&idc=useast8"]},"link":"aweme://user/profile/7019811528040367109?sec_uid=MS4wLjABAAAA6l4bHgDxc3aZPlMYQvuq4K5rnUIIYWPfUjdsFlzKyCVBfKH-gczfRah5vKXjPbrj&from_scene=8"},"is_owner":false,"is_anonymous":false,"review_source_type":0,"review_source_name":"Purchased on TikTok","link":"","is_updated":false,"third_party_popup_title":"","third_party_popup_content":"","third_party_popup_button_text":""}],"review_count_str":"595","review_count_str_v2":"595"},"seller_id":"7496021452055022168"},"shop_info":{"seller_id":"7496021452055022168","sold_count":50887,"on_sell_product_count":14,"review_count":4215,"global_seller_id":"7496021452055022168","global_sold_count":"50887","followers_count":"1796","video_count":"100","enable_follow":true,"shop_name":"Manspot","shop_logo":{"height":300,"width":300,"uri":"tos-useast5-i-omjb5zjo8w-tx/c34696c75ae64397911e2e06193a12cc","url_list":["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c34696c75ae64397911e2e06193a12cc~tplv-fhlh96nyum-resize-webp:300:300.webp?dr=0&from=2422056039&idc=useast8&ps=933b5bde&shcp=607f11de&shp=905da467&t=555f072d"]},"shop_rating":"4.4","shop_link":"https://www.tiktok.com/shop/store/manspot/7496021452055022168","background":{"is_default":true,"image":{"height":300,"width":300,"uri":"tos-useast5-i-omjb5zjo8w-tx/c34696c75ae64397911e2e06193a12cc","url_list":["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c34696c75ae64397911e2e06193a12cc~tplv-fhlh96nyum-resize-webp:300:300.webp?dr=0&from=2422056039&idc=useast8&ps=933b5bde&shcp=607f11de&shp=905da467&t=555f072d"]},"shop_background_type":3},"format_sold_count":"50.8K+","region":"US","display_on_sell_product_count":"14","format_global_sold_count":"50.8K+","format_followers_count":"1.7K+","format_video_count":"100","store_sub_score":[{"score":0.9787,"type":1,"score_percentage":"98","high_light_tag":1,"platform_rate_type":0}],"worst_rating":"0","best_rating":"5","creator_name":"Manspot","shop_identity_label":{"label_type":2,"identity_label_text":"OFFICIAL SHOP","identity_logo_light":{"height":144,"width":144,"ratio":0,"minetype":"image/png","uri":"tos-useast5-i-omjb5zjo8w-tx/e6ee5e25d8a049b39c897d02fe9d3fd4","url_list":["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e6ee5e25d8a049b39c897d02fe9d3fd4~tplv-fhlh96nyum-origin-png.png?dr=0&from=2422056039&idc=useast8&ps=933b5bde&shcp=607f11de&shp=905da467&t=555f072d"]}},"desc":"Shop Manspot on TikTok Shop! 50.8K+ sold, 1.7K+ followers. 84+% positive feedback. 97+% Ships in 48h, 98+% replies in 24h. Join the trend!"},"shop_performance":[{"score_percentile":98,"type":1}],"related_videos":[{"item_id":"7527142083258305822","height":1920,"width":1080,"duration":57900,"author_id":"6680168318781539334","play_count":324944,"like_count":1812,"upload_time":"1752549352","expiration_time":"1754373525","title":"#clippers #manspot #balltrimmerformen #cleanshave #intimatetrimmer ","cover_image_url":"https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o8EuB9REQEAfeQLrDo7AjEqsVBFWXjdDckKa4u~tplv-tiktokx-360p.jpeg?dr=9616&refresh_token=1766d771&x-expires=1754434800&x-signature=lRWsCgvnwEp6UQqLhsH0PgRn88M%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8&s=TTEC_PDP_WEB&ftpl=1","content_url":"https://v16m-default.tiktokcdn-us.com/dd4ea5ea67c5f3bff2da44a43344e9d0/68919d95/video/tos/useast8/tos-useast8-ve-0068c001-tx2/o8IDodguOBacEBEqW4WEKsUAEjVfrXQQjAfFRj/?a=0&bti=MzV2KXVmcnZmd0BqOjo2QDI6bWJsK2IrYnFgIzE0M2A%3D&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C0&cv=1&br=2308&bt=1154&cs=0&ds=6&ft=LlnQ7z4HhWH6Bbg7.FLo0PD1&mime_type=video_mp4&qs=0&rc=ZzM0PDtnaWQ8NTVpZmk2O0BpM2U2bnE5cjl2NDMzaTczNEA2YmMtLi00XmIxYzE1YGNfYSNlYGBeMmRrX25hLS1kMTJzcw%3D%3D&vvpl=1&l=202508042357476500B0C762E3A801E8F3&btag=e00088000","author_name":"❤️ Brittney ❤️","author_avatar_url":"https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/9fbaf570003150d9888e44ed5b03b03c~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=1d0acc0f&x-expires=1754434800&x-signature=BqNkRAZzwhzBPbXPm%2FzMqw5FKzQ%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8","bc_ad_label_text":"Commission paid","url":"https://www.tiktok.com/@6680168318781539334/video/7527142083258305822","author_url":"https://www.tiktok.com/@6680168318781539334"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/shop/product/reviews":{"post":{"operationId":"social_tiktok_shop_product_reviews","x-nexscope-slug":"social-tiktok-shop-product-reviews","summary":"TikTok Shop Product Reviews","description":"Fetches customer reviews for a TikTok Shop product by URL or product_id. Returns `product_reviews`, an array of review objects each with `rating`, `display_text`, `review_timestamp_fmt`, `review_user` (name, avatar), and `sku_specification` (variant purchased); also returns `total_reviews` count and `rating_distribution`. Paginate with `page`. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Shop Product Reviews API View Pricing Get a product's reviews 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the product (required if product_id is not provided)"},"product_id":{"type":"string","description":"The ID of the product (required if url is not provided)"},"region":{"type":"string","description":"The region of the product. US is the reliable region right now; non-US regions should not be considered reliable and may return limited or inconsistent review data. Sorry for the inconvenience."},"page":{"type":"number","description":"The page number of the reviews"}},"required":[],"additionalProperties":false},"example":{"url":"https://www.tiktok.com/shop/pdp/cat-nail-clipper-by-potaroma-adjustable-sizes-built-in-file-safe-for-kittens-cats/1731578642912612516"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok-shop","data":{"success":true,"has_more":true,"total_reviews":"5967","product_reviews":[{"review_id":"7449648277383333678","product_id":"1729412793274503379","sku_id":"1729480195115684051","reviewer_id":"7118466497416561707","review_rating":4,"review_time":"1734506431877","is_verified_purchase":true,"is_incentivized_review":false,"product_name":"OLOV Beard/Hair Shaver for Men - All-in-One Mens Grooming Kit with Trimmer for Beard, Nose, face, Cordless Hair Clippers Electric Razor, Black Comfort","reviewer_name":"W**n","reviewer_avatar_url":"https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/8a5ef54ee47fd27614d4d576879cd630~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=6e5d3b6e&x-expires=1771009200&x-signature=1HE0d6u3ZL2NY%2FWG88r8zUltKS4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=5f8d3399&idc=useast5","review_text":"Product arrived intact no issues. Love all the attachments. Cuts very very well. Charges quick and efficiently. The only reason I gave a 4 was listening to the reels it’s supposed to be nip free. That was a lie, I nipped my balls and that’s not fun. I took pics other than that great product.","display_image_url":"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c9460bee85df472a8455f33df693cb8d~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839","review_images":["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c9460bee85df472a8455f33df693cb8d~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839"],"sku_specification":"Black","review_country":"US"}],"review_ratings":{"review_count":"5967","overall_score":4.4,"rating_result":{"1":"475","2":"161","3":"289","4":"740","5":"4302"}}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/user/showcase":{"post":{"operationId":"social_tiktok_user_showcase","x-nexscope-slug":"social-tiktok-user-showcase","summary":"TikTok Shop User Showcase","description":"Fetches products featured in a TikTok user's public showcase — the products a creator promotes on their profile. Returns an array of product objects each with title, price, images, and shop details. Use POST request if pagination is cutting off too early. Just send the query params in the body. Gets public user's showcase products Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Shop User Showcase API View Pricing Get products from a TikTok user's public showcase. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"The handle of the user"},"region":{"type":"string","description":"Region to put the proxy in. Non-US TikTok Shop regions are not reliable right now and may return limited or inconsistent showcase data. Sorry for the inconvenience."},"cursor":{"type":"string","description":"The cursor to the next page of products"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"mrtiktokreviews"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok-shop","data":{"success":true,"products":[{"product_id":"1732210666230419545","title":"Be Bodywise Hair Growth Roll-On Serum | New Year New You Edition | 3% Rosemary, 3% Redensyl, 2% AnaGain | Precision Scalp Applicator | Paraben/Sulphate-Free | Non-Oily | DHT-Care Botanicals | 50ml","image":{"height":500,"width":500,"uri":"tos-useast5-i-omjb5zjo8w-tx/b4088e56fc3140799ab2e52674339db4","url_list":["https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/b4088e56fc3140799ab2e52674339db4~tplv-fhlh96nyum-crop-webp:500:500.webp?dr=12190&t=555f072d&ps=933b5bde&shp=4ee6669e&shcp=9b759fb9&idc=useast5&from=1323722398"]},"product_price_info":{"sku_id":"1732210669134516313","symbol_position":1,"show_currency_space":false,"currency_show_mode":1,"currency_name":"USD","currency_symbol":"$","sale_price_decimal":"46.58","origin_price_decimal":"53","sale_price_format":"46.58","origin_price_format":"53.00","discount_format":"12%","discount_decimal":"0.12","single_product_price_format":"46.58","single_product_price_decimal":"46.58","sale_price_integer_part_format":"46","sale_price_decimal_part_format":"58","decimal_point_symbol":".","promotion_deduction_details":{"seller_subtotal_deduction":"6.42","seller_subtotal_deduction_decimal":"6.42"}},"rate_info":{"score":4.5,"review_count":326},"sold_info":{"sold_count":5457},"seller_info":{"seller_id":"7495572938346760281"},"seo_url":{"updated_at":null,"canonical_url":"https://www.tiktok.com/shop/pdp/1732210666230419545","slug":"be-bodywise-hair-growth-roll-on-serum-new-year-new-you-edition-3-rosemary-3-redensyl-2-anagain-precision-scalp-applicator-paraben-sulphate-free-non-oily-dht-care-botanicals-50ml","type":2,"version":2}}],"cursor":"eyJwcm9kdWN0....."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/instagram/profile":{"post":{"operationId":"social_instagram_profile","x-nexscope-slug":"social-instagram-profile","summary":"Instagram Profile","description":"After recent Instagram changes, fetching creator metadata and posts requires several requests to Instagram, so this endpoint can be slower. If you only need profile details without posts, use [Basic Profile](https://docs.scrapecreators.com/v1/instagram/basic-profile) with the numeric userId for a usually faster lookup. Retrieves comprehensive public Instagram profile information including biography, bio links, follower and following counts, verification status, and profile picture URLs. Private profiles also return all available public profile metadata through the same existing data.user mapper: ID, username, full name, biography and bio links/entities, website/linkshim, standard/HD profile photos, verification, business/professional/category information, public contact fields when Instagram returns them, and counts, without exposing private posts. The response and unchanged status, success, error, message, and billing rules are described below. Also returns recent timeline posts with engagement metrics such as likes, comments, and video view counts, plus a list of related profiles. Useful for account overview, audience analysis, or discovering similar creators. Instagram does not expose reliable pinned-post metadata through this public source, so do not infer pins from returned order. Video play counts are separate from video view counts. Profile-pinned videos may have video_play_count=null when their count is not found in a short recent-Reels scan; available pinned counts are kept and non-pinned videos require numeric plays. Use /v1/instagram/post with an individual post or reel URL for a deeper play-count lookup. Instagram may return media_count as null or return only the current post batch in edge_owner_to_timeline_media.count. Use Profile Post Count when you specifically need the total number of posts. An explicit rendered age gate (for example, You must be 21 years old or over to see this profile. Log in to continue.) returns HTTP 403, success=true, age_restricted=true, error=forbidden, errorStatus=403, and message=Profile is age restricted, without charging credits. This means Instagram identified an existing profile but requires an age-verified login to view it; we do not bypass the gate. It applies to GET, trimmed GET, and POST handle requests. The age_restricted field is omitted when age gating has not been explicitly confirmed; its absence is not proof that the account has no age limit. For GET handle requests, Profile is private means Instagram returned is_private=true. Account doesn't exist means the handle lookup returned no matching account, not confirmed deletion. The historical Profile is restricted placeholder was used for reported content with no public timeline items. Its handler compatibility branch remains, but the current metadata-first pipeline no longer infers restriction from an empty timeline alone; it retains matching metadata as a partial HTTP 200. These placeholders return HTTP 200, success=true, error=not_found, errorStatus=404, and userId=null, and cost one credit. An explicitly rendered generic audience restriction returns HTTP 404 with Profile is restricted and zero credits charged; it does not confirm an age limit. Profile is unavailable on Instagram also returns an uncharged HTTP 404 and does not identify privacy, deletion, or age gating. HTTP 500 with Shoot, IG is blocking us. Try again and it should work. is an uncharged upstream failure, not a confirmed account restriction. Do not label generic login prompts or unavailable responses as age-restricted.\n\n### Profile access response contract\n\nThe confirmed-state success flag is intentionally restored to true: success means we determined the profile state, not that the profile exists or its content is publicly retrievable. HTTP 403/404 and zero-credit billing remain unchanged. Actual retrieval failures remain success=false. HTTP status, JSON field names/types, error values, message values, and credit behavior are compatibility-sensitive. We preserve them on existing endpoint versions; incompatible changes require an explicitly versioned contract and advance notice. See the [response-contract changelog](/#response-contract-changelog).\n\n**Confirmed age gate — HTTP 403, zero credits.** For this profile endpoint, branch on errorStatus === 403 && age_restricted === true. The flag means Instagram explicitly rendered an age-verification gate, not a generic login prompt. It is omitted otherwise; omission does not mean false. It does not identify country/region restrictions.\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 100,\n  \"credits_charged\": 0,\n  \"handle\": \"example_profile\",\n  \"userId\": null,\n  \"age_restricted\": true,\n  \"error\": \"forbidden\",\n  \"errorStatus\": 403,\n  \"message\": \"Profile is age restricted\"\n}\n```\n\n**Explicit audience restriction — HTTP 404, zero credits.** This is different from an age gate and from an unavailable profile. There is currently no structured age/region reason field for this case: use HTTP 404, error=not_found, and the exact message below. Do not invent a reason or treat every 404 as a deleted account.\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 100,\n  \"credits_charged\": 0,\n  \"handle\": \"example_profile\",\n  \"userId\": null,\n  \"error\": \"not_found\",\n  \"errorStatus\": 404,\n  \"message\": \"Profile is restricted\"\n}\n```\n\n**Confirmed unavailable page — HTTP 404, zero credits.** Instagram reports the profile as unavailable. This does not establish whether it was deleted, renamed, suspended, or hidden. This response intentionally has no handle, userId, or age_restricted field.\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 100,\n  \"credits_charged\": 0,\n  \"error\": \"not_found\",\n  \"errorStatus\": 404,\n  \"message\": \"Profile is unavailable on Instagram\"\n}\n```\n\n**Legacy GET placeholders — HTTP 200, one credit.** These still exist. A JSON errorStatus of 404 is not the HTTP status. HTTP 200 and success=true alone do not prove usable profile data. The three legacy messages are preserved exactly:\n\n**Private profile public metadata.** Private profiles return all available public profile metadata through the existing data.user shape: ID, username, full name, biography, bio links/entities, external website/linkshim, standard/HD profile photos, verification, privacy, business/professional/category information, public contact fields when Instagram returns them, and counts. Full GET and POST handle requests use the complete existing public-profile user mapper; its fields and defaults remain unchanged except that unknown or unusable private follower/following counts are null, while a real 0 is preserved. The count paths remain data.user.edge_followed_by.count (followers) and data.user.edge_follow.count (following).\n\nGET trim=true uses the existing public-profile trim field list, retaining name, biography, bio links/entities, external_url, profile photos, privacy/verification, business/professional flags, category_name, business_address_json, and counts. Full-only fields such as external_url_linkshimmed, business_email, and business_phone_number are omitted from trimmed GET. POST handle requests ignore trim and return the full mapped user, as before.\n\nFull metadata means all mapped profile fields, not raw Instagram internals, private posts, or an age-gate bypass. Public contact information is not guaranteed; unavailable values keep the public mapper's existing defaults. Age-restricted responses are unchanged. Every preexisting top-level field is retained: HTTP 200, userId=null, error=not_found, errorStatus=404, message=Profile is private, and the one-credit charge stay unchanged. POST handle requests keep success=false instead of GET's success=true. The example below shows representative metadata fields, not the exhaustive full mapper output or the trimmed field set. The ID, name, links, photos, handle, and credit balance are synthetic; the counts 560 and 4675 are illustrative and can change.\n\nPrivate GET response (representative full-response metadata):\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 99,\n  \"credits_charged\": 1,\n  \"handle\": \"example_profile\",\n  \"userId\": null,\n  \"error\": \"not_found\",\n  \"errorStatus\": 404,\n  \"message\": \"Profile is private\",\n  \"data\": {\n    \"user\": {\n      \"id\": \"12345\",\n      \"username\": \"example_profile\",\n      \"full_name\": \"Example Profile\",\n      \"biography\": \"An example profile. https://example.org/\",\n      \"bio_links\": [\n        {\n          \"title\": \"Website\",\n          \"url\": \"https://example.org/\",\n          \"lynx_url\": \"https://example.org/linkshim\",\n          \"link_type\": \"external\"\n        }\n      ],\n      \"fb_profile_biolink\": null,\n      \"biography_with_entities\": {\n        \"raw_text\": \"An example profile. https://example.org/\",\n        \"entities\": []\n      },\n      \"external_url\": \"https://example.org/\",\n      \"external_url_linkshimmed\": \"https://example.org/linkshim\",\n      \"profile_pic_url\": \"https://example.org/profile.jpg\",\n      \"profile_pic_url_hd\": \"https://example.org/profile-hd.jpg\",\n      \"is_verified\": false,\n      \"is_business_account\": false,\n      \"is_professional_account\": false,\n      \"category_name\": null,\n      \"business_category_name\": null,\n      \"overall_category_name\": null,\n      \"category_enum\": null,\n      \"business_address_json\": {},\n      \"business_contact_method\": \"UNKNOWN\",\n      \"business_email\": null,\n      \"business_phone_number\": null,\n      \"should_show_category\": false,\n      \"should_show_public_contacts\": false,\n      \"is_private\": true,\n      \"edge_followed_by\": {\n        \"count\": 560\n      },\n      \"edge_follow\": {\n        \"count\": 4675\n      }\n    }\n  }\n}\n```\n\nHistorical restricted-result compatibility branch (not the current empty-timeline policy):\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 99,\n  \"credits_charged\": 1,\n  \"handle\": \"example_profile\",\n  \"userId\": null,\n  \"error\": \"not_found\",\n  \"errorStatus\": 404,\n  \"message\": \"Profile is restricted\"\n}\n```\n\nNo matching account from the handle lookup (not proof of deletion):\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 99,\n  \"credits_charged\": 1,\n  \"handle\": \"example_profile\",\n  \"userId\": null,\n  \"error\": \"not_found\",\n  \"errorStatus\": 404,\n  \"message\": \"Account doesn't exist\"\n}\n```\n\nThese legacy handler branches are retained, but the active metadata-first pipeline no longer emits the heuristic restricted result merely because the timeline is empty; it returns useful matching metadata as a partial HTTP 200 instead. GET trim=true retains the same state-envelope rules. POST handle requests retain a historical difference: these HTTP-200 placeholders have success=false instead of true; they still cost one credit. The POST restricted-placeholder condition is data.user === null, while GET uses userId === null. The explicit 403/404 responses above apply to both methods. A flag-only legacy restricted scraper result is different again: POST can pass through success=true, handle, userId=null, message=Profile is restricted, and isRestricted=true without error/errorStatus. Legacy POST userId requests use a separate compatibility path and are not covered by the handle contract.\n\n**Endpoint scope.** /v1/instagram/user/posts and /v2/instagram/user/posts also return the uncharged 403 forbidden age-gate message, but do not include age_restricted, handle, or userId in that error body. Their explicit restricted-profile 404 says Profile is private, not Profile is restricted. Do not copy this profile endpoint's envelope to /v1/instagram/post or /v1/tiktok/profile; those contracts are separate. Ambiguous upstream failures are not evidence of a missing or restricted account. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Profile API View Pricing Get public profile details, recent posts, and related accounts. Private profiles return public details only. Pinned-post metadata is not reliably available; returned order does not identify pins. 1 credit per request\nAfter recent Instagram changes, fetching creator metadata and posts requires several requests to Instagram, so this endpoint can be slower. If you only need profile details without posts, use [Basic Profile](https://docs.scrapecreators.com/v1/instagram/basic-profile) with the numeric userId for a usually faster lookup. Retrieves comprehensive public Instagram profile information including biography, bio links, follower and following counts, verification status, and profile picture URLs. Private profiles also return all available public profile metadata through the same existing data.user mapper: ID, username, full name, biography and bio links/entities, website/linkshim, standard/HD profile photos, verification, business/professional/category information, public contact fields when Instagram returns them, and counts, without exposing private posts. The response and unchanged status, success, error, message, and billing rules are described below. Also returns recent timeline posts with engagement metrics such as likes, comments, and video view counts, plus a list of related profiles. Useful for account overview, audience analysis, or discovering similar creators. Instagram does not expose reliable pinned-post metadata through this public source, so do not infer pins from returned order. Video play counts are separate from video view counts. Profile-pinned videos may have video_play_count=null when their count is not found in a short recent-Reels scan; available pinned counts are kept and non-pinned videos require numeric plays. Use /v1/instagram/post with an individual post or reel URL for a deeper play-count lookup. Instagram may return media_count as null or return only the current post batch in edge_owner_to_timeline_media.count. Use Profile Post Count when you specifically need the total number of posts. An explicit rendered age gate (for example, You must be 21 years old or over to see this profile. Log in to continue.) returns HTTP 403, success=true, age_restricted=true, error=forbidden, errorStatus=403, and message=Profile is age restricted, without charging credits. This means Instagram identified an existing profile but requires an age-verified login to view it; we do not bypass the gate. It applies to GET, trimmed GET, and POST handle requests. The age_restricted field is omitted when age gating has not been explicitly confirmed; its absence is not proof that the account has no age limit. For GET handle requests, Profile is private means Instagram returned is_private=true. Account doesn't exist means the handle lookup returned no matching account, not confirmed deletion. The historical Profile is restricted placeholder was used for reported content with no public timeline items. Its handler compatibility branch remains, but the current metadata-first pipeline no longer infers restriction from an empty timeline alone; it retains matching metadata as a partial HTTP 200. These placeholders return HTTP 200, success=true, error=not_found, errorStatus=404, and userId=null, and cost one credit. An explicitly rendered generic audience restriction returns HTTP 404 with Profile is restricted and zero credits charged; it does not confirm an age limit. Profile is unavailable on Instagram also returns an uncharged HTTP 404 and does not identify privacy, deletion, or age gating. HTTP 500 with Shoot, IG is blocking us. Try again and it should work. is an uncharged upstream failure, not a confirmed account restriction. Do not label generic login prompts or unavailable responses as age-restricted.\n\n### Profile access response contract\n\nThe confirmed-state success flag is intentionally restored to true: success means we determined the profile state, not that the profile exists or its content is publicly retrievable. HTTP 403/404 and zero-credit billing remain unchanged. Actual retrieval failures remain success=false. HTTP status, JSON field names/types, error values, message values, and credit behavior are compatibility-sensitive. We preserve them on existing endpoint versions; incompatible changes require an explicitly versioned contract and advance notice. See the [response-contract changelog](/#response-contract-changelog).\n\n**Confirmed age gate — HTTP 403, zero credits.** For this profile endpoint, branch on errorStatus === 403 && age_restricted === true. The flag means Instagram explicitly rendered an age-verification gate, not a generic login prompt. It is omitted otherwise; omission does not mean false. It does not identify country/region restrictions.\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 100,\n  \"credits_charged\": 0,\n  \"handle\": \"example_profile\",\n  \"userId\": null,\n  \"age_restricted\": true,\n  \"error\": \"forbidden\",\n  \"errorStatus\": 403,\n  \"message\": \"Profile is age restricted\"\n}\n```\n\n**Explicit audience restriction — HTTP 404, zero credits.** This is different from an age gate and from an unavailable profile. There is currently no structured age/region reason field for this case: use HTTP 404, error=not_found, and the exact message below. Do not invent a reason or treat every 404 as a deleted account.\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 100,\n  \"credits_charged\": 0,\n  \"handle\": \"example_profile\",\n  \"userId\": null,\n  \"error\": \"not_found\",\n  \"errorStatus\": 404,\n  \"message\": \"Profile is restricted\"\n}\n```\n\n**Confirmed unavailable page — HTTP 404, zero credits.** Instagram reports the profile as unavailable. This does not establish whether it was deleted, renamed, suspended, or hidden. This response intentionally has no handle, userId, or age_restricted field.\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 100,\n  \"credits_charged\": 0,\n  \"error\": \"not_found\",\n  \"errorStatus\": 404,\n  \"message\": \"Profile is unavailable on Instagram\"\n}\n```\n\n**Legacy GET placeholders — HTTP 200, one credit.** These still exist. A JSON errorStatus of 404 is not the HTTP status. HTTP 200 and success=true alone do not prove usable profile data. The three legacy messages are preserved exactly:\n\n**Private profile public metadata.** Private profiles return all available public profile metadata through the existing data.user shape: ID, username, full name, biography, bio links/entities, external website/linkshim, standard/HD profile photos, verification, privacy, business/professional/category information, public contact fields when Instagram returns them, and counts. Full GET and POST handle requests use the complete existing public-profile user mapper; its fields and defaults remain unchanged except that unknown or unusable private follower/following counts are null, while a real 0 is preserved. The count paths remain data.user.edge_followed_by.count (followers) and data.user.edge_follow.count (following).\n\nGET trim=true uses the existing public-profile trim field list, retaining name, biography, bio links/entities, external_url, profile photos, privacy/verification, business/professional flags, category_name, business_address_json, and counts. Full-only fields such as external_url_linkshimmed, business_email, and business_phone_number are omitted from trimmed GET. POST handle requests ignore trim and return the full mapped user, as before.\n\nFull metadata means all mapped profile fields, not raw Instagram internals, private posts, or an age-gate bypass. Public contact information is not guaranteed; unavailable values keep the public mapper's existing defaults. Age-restricted responses are unchanged. Every preexisting top-level field is retained: HTTP 200, userId=null, error=not_found, errorStatus=404, message=Profile is private, and the one-credit charge stay unchanged. POST handle requests keep success=false instead of GET's success=true. The example below shows representative metadata fields, not the exhaustive full mapper output or the trimmed field set. The ID, name, links, photos, handle, and credit balance are synthetic; the counts 560 and 4675 are illustrative and can change.\n\nPrivate GET response (representative full-response metadata):\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 99,\n  \"credits_charged\": 1,\n  \"handle\": \"example_profile\",\n  \"userId\": null,\n  \"error\": \"not_found\",\n  \"errorStatus\": 404,\n  \"message\": \"Profile is private\",\n  \"data\": {\n    \"user\": {\n      \"id\": \"12345\",\n      \"username\": \"example_profile\",\n      \"full_name\": \"Example Profile\",\n      \"biography\": \"An example profile. https://example.org/\",\n      \"bio_links\": [\n        {\n          \"title\": \"Website\",\n          \"url\": \"https://example.org/\",\n          \"lynx_url\": \"https://example.org/linkshim\",\n          \"link_type\": \"external\"\n        }\n      ],\n      \"fb_profile_biolink\": null,\n      \"biography_with_entities\": {\n        \"raw_text\": \"An example profile. https://example.org/\",\n        \"entities\": []\n      },\n      \"external_url\": \"https://example.org/\",\n      \"external_url_linkshimmed\": \"https://example.org/linkshim\",\n      \"profile_pic_url\": \"https://example.org/profile.jpg\",\n      \"profile_pic_url_hd\": \"https://example.org/profile-hd.jpg\",\n      \"is_verified\": false,\n      \"is_business_account\": false,\n      \"is_professional_account\": false,\n      \"category_name\": null,\n      \"business_category_name\": null,\n      \"overall_category_name\": null,\n      \"category_enum\": null,\n      \"business_address_json\": {},\n      \"business_contact_method\": \"UNKNOWN\",\n      \"business_email\": null,\n      \"business_phone_number\": null,\n      \"should_show_category\": false,\n      \"should_show_public_contacts\": false,\n      \"is_private\": true,\n      \"edge_followed_by\": {\n        \"count\": 560\n      },\n      \"edge_follow\": {\n        \"count\": 4675\n      }\n    }\n  }\n}\n```\n\nHistorical restricted-result compatibility branch (not the current empty-timeline policy):\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 99,\n  \"credits_charged\": 1,\n  \"handle\": \"example_profile\",\n  \"userId\": null,\n  \"error\": \"not_found\",\n  \"errorStatus\": 404,\n  \"message\": \"Profile is restricted\"\n}\n```\n\nNo matching account from the handle lookup (not proof of deletion):\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 99,\n  \"credits_charged\": 1,\n  \"handle\": \"example_profile\",\n  \"userId\": null,\n  \"error\": \"not_found\",\n  \"errorStatus\": 404,\n  \"message\": \"Account doesn't exist\"\n}\n```\n\nThese legacy handler branches are retained, but the active metadata-first pipeline no longer emits the heuristic restricted result merely because the timeline is empty; it returns useful matching metadata as a partial HTTP 200 instead. GET trim=true retains the same state-envelope rules. POST handle requests retain a historical difference: these HTTP-200 placeholders have success=false instead of true; they still cost one credit. The POST restricted-placeholder condition is data.user === null, while GET uses userId === null. The explicit 403/404 responses above apply to both methods. A flag-only legacy restricted scraper result is different again: POST can pass through success=true, handle, userId=null, message=Profile is restricted, and isRestricted=true without error/errorStatus. Legacy POST userId requests use a separate compatibility path and are not covered by the handle contract.\n\n**Endpoint scope.** /v1/instagram/user/posts and /v2/instagram/user/posts also return the uncharged 403 forbidden age-gate message, but do not include age_restricted, handle, or userId in that error body. Their explicit restricted-profile 404 says Profile is private, not Profile is restricted. Do not copy this profile endpoint's envelope to /v1/instagram/post or /v1/tiktok/profile; those contracts are separate. Ambiguous upstream failures are not evidence of a missing or restricted account.\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"handle":{"maxLength":31,"type":"string","pattern":"^@?[A-Za-z0-9._]{1,30}$","minLength":1},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"},"cacheMaxAge":{"enum":["1d","3d","7d","14d","30d"],"type":"string"}},"additionalProperties":false,"type":"object","required":["handle"]},"example":{"handle":"scrapecreators"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"platform":{"enum":["instagram","youtube","reddit","pinterest"],"type":"string"},"resourceStatus":{"enum":["AVAILABLE","PARTIAL","PRIVATE","RESTRICTED","NOT_FOUND","NO_TRANSCRIPT","UNKNOWN"],"type":"string"},"fetchedAt":{"format":"date-time","type":"string"},"sourceFetchedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"usage":{"properties":{"billingStatus":{"enum":["NOT_CHARGED","SETTLED","UNKNOWN"],"type":"string"},"chargedCredits":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["billingStatus","chargedCredits"]},"profile":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"followerCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"followingCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"postCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"isPrivate":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","handle","name","bio","url","avatarUrl","followerCount","followingCount","postCount","isPrivate"]},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["platform","resourceStatus","fetchedAt","sourceFetchedAt","usage","profile"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","resourceStatus":"NOT_FOUND","fetchedAt":"2026-10-28T00:00:00Z","sourceFetchedAt":null,"usage":{"billingStatus":"UNKNOWN","chargedCredits":null},"profile":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/instagram/basic-profile":{"post":{"operationId":"social_instagram_basic_profile","x-nexscope-slug":"social-instagram-basic-profile","summary":"Instagram Basic Profile","description":"Fetches a lightweight Instagram profile summary by user ID, returning username, full name, biography, profile picture URL, verification status, follower count, following count, media count, and account privacy and type. Ideal for quick lookups or enrichment when you already have the numeric user ID. Use this when speed matters and you do not need posts. It skips the post-fetching and enrichment calls made by [Profile](https://docs.scrapecreators.com/v1/instagram/profile), so it is usually faster. Response times can vary. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Basic Profile API View Pricing Get profile details without posts using a numeric userId. Usually faster than Profile. 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","description":"Instagram user id"},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":[],"additionalProperties":false},"example":{"userId":"314216"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","data":{"success":true,"friendship_status":null,"gating":null,"is_memorialized":false,"is_private":false,"has_story_archive":null,"supervision_info":null,"is_regulated_c18":false,"regulated_news_in_locations":[],"bio_links":[],"linked_fb_info":null,"text_post_app_badge_label":"zuck","show_text_post_app_badge":true,"username":"zuck","text_post_new_post_count":null,"pk":"314216","live_broadcast_visibility":null,"live_broadcast_id":null,"profile_pic_url":"https://instagram.fpoz4-1.fna.fbcdn.net/v/t51.2885-19/550234512_18532404670058217_8758519395071163708_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.fpoz4-1.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2QENWmroLq0Z2oxDXF-wYN4Txpcg88E2n5GZTMYtQgXKAlUWi1gMsQQilbgL7mYspgA&_nc_ohc=vS_PAWzWFjcQ7kNvwEe9m50&_nc_gid=AOVYXTTsY5VI85UshvRoHA&edm=ALGbJPMBAAAA&ccb=7-5&oh=00_AfcUDbyLkAcHCLaaiVpvfv4AvlKuZUdsos_eZmuWHS02NQ&oe=68EB29FB&_nc_sid=7d3ac5","hd_profile_pic_url_info":{"url":"https://instagram.fpoz4-1.fna.fbcdn.net/v/t51.2885-19/550234512_18532404670058217_8758519395071163708_n.jpg?efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.fpoz4-1.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2QENWmroLq0Z2oxDXF-wYN4Txpcg88E2n5GZTMYtQgXKAlUWi1gMsQQilbgL7mYspgA&_nc_ohc=vS_PAWzWFjcQ7kNvwEe9m50&_nc_gid=AOVYXTTsY5VI85UshvRoHA&edm=ALGbJPMBAAAA&ccb=7-5&oh=00_AfcBW_k3ngIbA43oUKKZ9SPx-FtlrQSSbOWg8npnXGqCcg&oe=68EB29FB&_nc_sid=7d3ac5"},"is_unpublished":false,"latest_reel_media":0,"has_profile_pic":null,"profile_pic_genai_tool_info":[],"biography":"I build stuff","full_name":"Mark Zuckerberg","is_verified":true,"show_account_transparency_details":true,"account_type":3,"follower_count":16101999,"mutual_followers_count":null,"profile_context_links_with_user_ids":null,"address_street":null,"city_name":null},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/instagram/posts":{"post":{"operationId":"social_instagram_posts","x-nexscope-slug":"social-instagram-posts","summary":"Instagram Posts","description":"Returns a paginated feed of a user's public Instagram posts, including reels, photos, videos, and carousels. Each item includes media type, shortcode, caption text, like count, comment count, play count, video URLs, image URLs, tagged users, and the published time in `items[].created_at` as an ISO 8601 UTC date. When supplied by Instagram, the media-level `fbid` is also returned. The original Unix timestamp remains available in `items[].taken_at`. Play counts reflect Instagram-only views and exclude cross-posted Facebook views. Supports cursor-based pagination via next_max_id for scrolling through the full timeline.\n\n### Profile access errors\n\nThese confirmed handle-resolution states on /v1/instagram/user/posts and /v2/instagram/user/posts return success=true even with HTTP 403/404. A confirmed state is a completed lookup, not a scraper failure. This approved boolean correction does not change status codes, messages, fields, or zero-credit billing. Actual retrieval failures remain success=false. Preserve each endpoint's response contract; see the [response-contract changelog](/#response-contract-changelog).\n\nA confirmed age gate returns HTTP 403 and zero credits. Unlike /v1/instagram/profile, these routes do not include age_restricted, handle, or userId in this error response:\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 100,\n  \"credits_charged\": 0,\n  \"error\": \"forbidden\",\n  \"errorStatus\": 403,\n  \"message\": \"Profile is age restricted\"\n}\n```\n\nAn explicit restricted-profile error returns HTTP 404 and zero credits, with the exact message Profile is private:\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 100,\n  \"credits_charged\": 0,\n  \"error\": \"not_found\",\n  \"errorStatus\": 404,\n  \"message\": \"Profile is private\"\n}\n```\n\nAn explicitly confirmed unavailable profile returns HTTP 404 and zero credits:\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 100,\n  \"credits_charged\": 0,\n  \"error\": \"not_found\",\n  \"errorStatus\": 404,\n  \"message\": \"Profile is unavailable on Instagram\"\n}\n```\n\nThese are the explicit handle-resolution error branches, not a blanket description of every historical 404 fallback. The v2 route also retains legacy success=true HTTP-404 bodies (Posts not found, Account doesn't exist, or Profile is restricted). They differ in fields and legacy behavior from the explicit confirmed-state responses above; success=true alone does not distinguish them. No age-vs-region reason field is exposed. A generic login prompt does not establish age gating, and unavailability does not prove deletion. /v1/instagram/post and /v1/tiktok/profile have separate error contracts.\n\nPlay counts can sometimes be inaccurate. Access-response examples distinguish confirmed age gates, restrictions, and unavailable profiles; existing legacy responses are retained. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Posts API View Pricing Get public posts and reels with pagination. Play counts may be inaccurate and exclude Facebook views. Check access-response messages, not just HTTP status. 1 credit per request\nReturns a paginated feed of a user's public Instagram posts, including reels, photos, videos, and carousels. Each item includes media type, shortcode, caption text, like count, comment count, play count, video URLs, image URLs, tagged users, and the published time in `items[].created_at` as an ISO 8601 UTC date. When supplied by Instagram, the media-level `fbid` is also returned. The original Unix timestamp remains available in `items[].taken_at`. Play counts reflect Instagram-only views and exclude cross-posted Facebook views. Supports cursor-based pagination via next_max_id for scrolling through the full timeline.\n\n### Profile access errors\n\nThese confirmed handle-resolution states on /v1/instagram/user/posts and /v2/instagram/user/posts return success=true even with HTTP 403/404. A confirmed state is a completed lookup, not a scraper failure. This approved boolean correction does not change status codes, messages, fields, or zero-credit billing. Actual retrieval failures remain success=false. Preserve each endpoint's response contract; see the [response-contract changelog](/#response-contract-changelog).\n\nA confirmed age gate returns HTTP 403 and zero credits. Unlike /v1/instagram/profile, these routes do not include age_restricted, handle, or userId in this error response:\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 100,\n  \"credits_charged\": 0,\n  \"error\": \"forbidden\",\n  \"errorStatus\": 403,\n  \"message\": \"Profile is age restricted\"\n}\n```\n\nAn explicit restricted-profile error returns HTTP 404 and zero credits, with the exact message Profile is private:\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 100,\n  \"credits_charged\": 0,\n  \"error\": \"not_found\",\n  \"errorStatus\": 404,\n  \"message\": \"Profile is private\"\n}\n```\n\nAn explicitly confirmed unavailable profile returns HTTP 404 and zero credits:\n\n```json\n{\n  \"success\": true,\n  \"credits_remaining\": 100,\n  \"credits_charged\": 0,\n  \"error\": \"not_found\",\n  \"errorStatus\": 404,\n  \"message\": \"Profile is unavailable on Instagram\"\n}\n```\n\nThese are the explicit handle-resolution error branches, not a blanket description of every historical 404 fallback. The v2 route also retains legacy success=true HTTP-404 bodies (Posts not found, Account doesn't exist, or Profile is restricted). They differ in fields and legacy behavior from the explicit confirmed-state responses above; success=true alone does not distinguish them. No age-vs-region reason field is exposed. A generic login prompt does not establish age gating, and unavailability does not prove deletion. /v1/instagram/post and /v1/tiktok/profile have separate error contracts.\n\nPlay counts can sometimes be inaccurate. Access-response examples distinguish confirmed age gates, restrictions, and unavailable profiles; existing legacy responses are retained.\nOnly the literal query value 'true' enables this check. It requires play_count on each returned video post; a real 0 is valid. It does not require ig_play_count or view counts, or counts on photos. If a required play_count is missing or null, the request returns an error without charging credits instead of a paid partial success. With the default false, counts remain best-effort: usable posts are still billable even with missing play counts. Retrying does not guarantee that Instagram will return the missing counts. [Why counts can be missing](https://scrapecreators.com/blog/instagram-play-counts-missing).","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"handle":{"maxLength":31,"type":"string","pattern":"^@?[A-Za-z0-9._]{1,30}$","minLength":1},"require_play_counts":{"type":"boolean","default":false,"description":"Only the literal query value 'true' enables this check. It requires play_count on each returned video post; a real 0 is valid. It does not require ig_play_count or view counts, or counts on photos. If a required play_count is missing or null, the request returns an error without charging credits instead of a paid partial success. With the default false, counts remain best-effort: usable posts are still billable even with missing play counts. Retrying does not guarantee that Instagram will return the missing counts. [Why counts can be missing](https://scrapecreators.com/blog/instagram-play-counts-missing)."},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"},"cursor":{"description":"Opaque single-page cursor, at most 65536 UTF-8 bytes.","type":"string","minLength":1}},"additionalProperties":false,"type":"object","required":["handle"]},"example":{"handle":"scrapecreators"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"platform":{"enum":["instagram","youtube","reddit","pinterest"],"type":"string"},"resourceStatus":{"enum":["AVAILABLE","PARTIAL","PRIVATE","RESTRICTED","NOT_FOUND","NO_TRANSCRIPT","UNKNOWN"],"type":"string"},"fetchedAt":{"format":"date-time","type":"string"},"sourceFetchedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"usage":{"properties":{"billingStatus":{"enum":["NOT_CHARGED","SETTLED","UNKNOWN"],"type":"string"},"chargedCredits":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["billingStatus","chargedCredits"]},"items":{"items":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"likeCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"commentCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"viewCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"type":{"enum":["POST","REEL","UNKNOWN"],"type":"string"},"author":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","handle","name","url"]},{"type":"null"}]},"media":{"items":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"enum":["IMAGE","VIDEO","UNKNOWN"],"type":"string"},"thumbnailUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["url","type","thumbnailUrl"]},"type":"array"}},"additionalProperties":false,"type":"object","required":["id","url","caption","publishedAt","likeCount","commentCount","viewCount","type","author","media"]},"type":"array"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"additionalProperties":false,"type":"object","required":["platform","resourceStatus","fetchedAt","sourceFetchedAt","usage","items","nextCursor","hasMore"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","resourceStatus":"NOT_FOUND","fetchedAt":"2026-10-28T00:00:00Z","sourceFetchedAt":null,"usage":{"billingStatus":"UNKNOWN","chargedCredits":null},"items":[],"nextCursor":null,"hasMore":false},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/instagram/user/tagged-posts":{"post":{"operationId":"social_instagram_user_tagged_posts","x-nexscope-slug":"social-instagram-user-tagged-posts","summary":"Instagram User Tagged Posts","description":"Returns up to 10 public posts per page from an Instagram user's Tagged tab. Each item is a flat post object with its shortcode, caption, media type, engagement counts, media URLs, and owner details. Keep passing the returned cursor to fetch additional pages until has_more is false. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram User Tagged Posts API View Pricing Get public posts that tag an Instagram user. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string","description":"Numeric Instagram user ID."},"cursor":{"type":"string","description":"Cursor returned by the previous response."}},"required":["user_id"],"additionalProperties":false},"example":{"user_id":"325734299"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","data":{"success":true,"posts":[{"pk":"3953402310668919030","code":"DbdTnSdoSD2","media_type":1,"caption":{"pk":"18139631029604360","text":"You get the best of both worlds ig"},"comment_count":0,"like_count":3,"view_count":null,"user":{"pk":"13320148665","id":"13320148665","username":"oceanecosplay"},"url":"https://www.instagram.com/p/DbdTnSdoSD2/"}],"cursor":"3953374600788032611","has_more":true},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/instagram/user/reels":{"post":{"operationId":"social_instagram_user_reels","x-nexscope-slug":"social-instagram-user-reels","summary":"Instagram Reels","description":"Returns a paginated list of a user's public Instagram reels (short-form videos). Each reel includes its shortcode, play count, like count, comment count, video versions with download URLs, thumbnail image, owner info, and the published time in `items[].media.created_at` as an ISO 8601 UTC date. With `trim=true`, use `items[].created_at`. The original Unix timestamp remains available as `taken_at`. Note that reel captions are not returned by this endpoint. Play counts are Instagram-only views and exclude cross-posted Facebook views. Supports cursor-based pagination via max_id; providing a user_id instead of a handle yields faster responses.\n\nPinned reels are not included. Use the post detail endpoint to get reel captions. Play counts can sometimes be inaccurate. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Reels API View Pricing Get public reels by user_id or handle. Pinned reels and captions are excluded. Play counts may be inaccurate and exclude Facebook views. Use Post for captions. 1 credit per request\nOnly the literal query value 'true' enables this check. It requires a numeric, nonnegative play_count on every returned Reel, in both full responses (items[].media.play_count) and trim=true responses (items[].play_count); a real 0 is valid. A missing, null, nonnumeric or negative play_count returns HTTP 503 without charging credits instead of a paid partial success. It does not require ig_play_count or view counts. With the default false, counts remain best-effort: usable reels are still billable even with missing play counts. This checks presence and numeric validity; it does not guarantee count accuracy or agreement with Instagram Insights. Retrying does not guarantee that Instagram will return the missing counts. [Why counts can be missing](https://scrapecreators.com/blog/instagram-play-counts-missing).","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string","description":"Instagram user id. Use this for faster response times."},"handle":{"type":"string","description":"Instagram handle. Use user_id for faster response times."},"require_play_counts":{"type":"boolean","default":false,"description":"Only the literal query value 'true' enables this check. It requires a numeric, nonnegative play_count on every returned Reel, in both full responses (items[].media.play_count) and trim=true responses (items[].play_count); a real 0 is valid. A missing, null, nonnumeric or negative play_count returns HTTP 503 without charging credits instead of a paid partial success. It does not require ig_play_count or view counts. With the default false, counts remain best-effort: usable reels are still billable even with missing play counts. This checks presence and numeric validity; it does not guarantee count accuracy or agreement with Instagram Insights. Retrying does not guarantee that Instagram will return the missing counts. [Why counts can be missing](https://scrapecreators.com/blog/instagram-play-counts-missing)."},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"},"max_id":{"type":"string","description":"Max id to get more reels. Get 'max_id' from previous response."}},"required":[],"additionalProperties":false},"example":{"handle":"jane"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","data":{"success":true,"items":[{"id":"3641924023820356866_21393171","code":"DKKtpqaxg0C","taken_at":1748371310,"created_at":"2025-05-27T18:41:50.000Z","caption":{"bit_flags":0,"created_at":1748371312,"created_at_utc":1748371312,"did_report_as_spam":false,"is_ranked_comment":false,"pk":"18079986955772842","share_enabled":false,"content_type":"comment","media_id":"3641924023820356866","status":"Active","type":1,"user_id":"21393171","strong_id__":"18079986955772842","text":"Summer brings out all the girlies, soda, and global warming!!!\uD83E\uDD17☀️\n\n#states #utah #idaho #california #oregon #newyork #minnesota #arizona #alaska #girlies #jane #janeinsane #eastcoast #westcoast #drama","user":{"pk":"21393171","pk_id":"21393171","id":"21393171","full_name":"Jane Williamson","is_private":false,"is_unpublished":false,"strong_id__":"21393171","fbid_v2":"17841400515130334","username":"jane","is_verified":true,"profile_pic_id":"3583980709961915639_21393171","profile_pic_url":"https://scontent-lga3-2.cdninstagram.com/v/t51.2885-19/482782944_496357423346018_5818268903424754264_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHH_AuDym1_h_Gt35CeYD9UUv5wiBJykWgz0pzbdkl_7HVH1k09gFjEGZGaaanoHrw&_nc_ohc=UOwY1iuLY14Q7kNvwF6T6a4&_nc_gid=26ktQKWC9pWQuqHYOHHLSQ&edm=ACHbZRIBAAAA&ccb=7-5&oh=00_AfNtjn382KDVjtIjCSaHRLBv-5axcS6DArSz3ceqiChSQw&oe=685A6928&_nc_sid=c024bc"},"is_covered":false,"private_reply_status":0},"play_count":1685367,"ig_play_count":1685367,"comment_count":1096,"like_count":71768,"display_uri":"https://scontent-lga3-2.cdninstagram.com/v/t51.2885-15/501064973_18499642795017172_3156358348692457402_n.jpg?stp=c0.469.1206.1206a_dst-jpg_e35_s1080x1080_sh0.08_tt6&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHH_AuDym1_h_Gt35CeYD9UUv5wiBJykWgz0pzbdkl_7HVH1k09gFjEGZGaaanoHrw&_nc_ohc=nqrFLRdKJkgQ7kNvwFsYpnt&_nc_gid=26ktQKWC9pWQuqHYOHHLSQ&edm=ACHbZRIBAAAA&ccb=7-5&oh=00_AfOZBf0XzICMS0v3EFHyXXbDmGCSkBBSD7yGH4KXyIlC3A&oe=685A3C9E&_nc_sid=c024bc","user":{"fbid_v2":"17841400515130334","feed_post_reshare_disabled":false,"full_name":"Jane Williamson","id":"21393171","is_private":false,"is_unpublished":false,"pk":"21393171","pk_id":"21393171","show_account_transparency_details":true,"strong_id__":"21393171","third_party_downloads_enabled":2,"account_type":3,"account_badges":[],"fan_club_info":{"autosave_to_exclusive_highlight":null,"connected_member_count":null,"fan_club_id":null,"fan_club_name":null,"has_created_ssc":null,"has_enough_subscribers_for_ssc":null,"is_fan_club_gifting_eligible":null,"is_fan_club_referral_eligible":null,"is_free_trial_eligible":null,"largest_public_bc_id":null,"subscriber_count":null,"fan_consideration_page_revamp_eligiblity":null},"has_anonymous_profile_picture":false,"hd_profile_pic_url_info":{"height":1024,"url":"https://scontent-lga3-2.cdninstagram.com/v/t51.2885-19/482782944_496357423346018_5818268903424754264_n.jpg?_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHH_AuDym1_h_Gt35CeYD9UUv5wiBJykWgz0pzbdkl_7HVH1k09gFjEGZGaaanoHrw&_nc_ohc=UOwY1iuLY14Q7kNvwF6T6a4&_nc_gid=26ktQKWC9pWQuqHYOHHLSQ&edm=ACHbZRIBAAAA&ccb=7-5&oh=00_AfMxQOnDe9llEUmo1gBn1-P5uo-mPtoJ4lTyy_GhgpgIkg&oe=685A6928&_nc_sid=c024bc","width":1024},"hd_profile_pic_versions":[{"height":320,"url":"https://scontent-lga3-2.cdninstagram.com/v/t51.2885-19/482782944_496357423346018_5818268903424754264_n.jpg?stp=dst-jpg_s320x320_tt6&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHH_AuDym1_h_Gt35CeYD9UUv5wiBJykWgz0pzbdkl_7HVH1k09gFjEGZGaaanoHrw&_nc_ohc=UOwY1iuLY14Q7kNvwF6T6a4&_nc_gid=26ktQKWC9pWQuqHYOHHLSQ&edm=ACHbZRIBAAAA&ccb=7-5&oh=00_AfOxDHstKKV5WkD6-9aKBxJ0mTttI5R3bZ26ZQn9Mg84Og&oe=685A6928&_nc_sid=c024bc","width":320}],"is_verified":true,"profile_pic_id":"3583980709961915639_21393171","profile_pic_url":"https://scontent-lga3-2.cdninstagram.com/v/t51.2885-19/482782944_496357423346018_5818268903424754264_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHH_AuDym1_h_Gt35CeYD9UUv5wiBJykWgz0pzbdkl_7HVH1k09gFjEGZGaaanoHrw&_nc_ohc=UOwY1iuLY14Q7kNvwF6T6a4&_nc_gid=26ktQKWC9pWQuqHYOHHLSQ&edm=ACHbZRIBAAAA&ccb=7-5&oh=00_AfNtjn382KDVjtIjCSaHRLBv-5axcS6DArSz3ceqiChSQw&oe=685A6928&_nc_sid=c024bc","transparency_product_enabled":false,"username":"jane","is_embeds_disabled":false,"eligible_for_text_app_activation_badge":false},"owner":{"fbid_v2":"17841400515130334","feed_post_reshare_disabled":false,"full_name":"Jane Williamson","id":"21393171","is_private":false,"is_unpublished":false,"pk":"21393171","pk_id":"21393171","show_account_transparency_details":true,"strong_id__":"21393171","third_party_downloads_enabled":2,"account_type":3,"account_badges":[],"fan_club_info":{"autosave_to_exclusive_highlight":null,"connected_member_count":null,"fan_club_id":null,"fan_club_name":null,"has_created_ssc":null,"has_enough_subscribers_for_ssc":null,"is_fan_club_gifting_eligible":null,"is_fan_club_referral_eligible":null,"is_free_trial_eligible":null,"largest_public_bc_id":null,"subscriber_count":null,"fan_consideration_page_revamp_eligiblity":null},"has_anonymous_profile_picture":false,"hd_profile_pic_url_info":{"height":1024,"url":"https://scontent-lga3-2.cdninstagram.com/v/t51.2885-19/482782944_496357423346018_5818268903424754264_n.jpg?_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHH_AuDym1_h_Gt35CeYD9UUv5wiBJykWgz0pzbdkl_7HVH1k09gFjEGZGaaanoHrw&_nc_ohc=UOwY1iuLY14Q7kNvwF6T6a4&_nc_gid=26ktQKWC9pWQuqHYOHHLSQ&edm=ACHbZRIBAAAA&ccb=7-5&oh=00_AfMxQOnDe9llEUmo1gBn1-P5uo-mPtoJ4lTyy_GhgpgIkg&oe=685A6928&_nc_sid=c024bc","width":1024},"hd_profile_pic_versions":[{"height":320,"url":"https://scontent-lga3-2.cdninstagram.com/v/t51.2885-19/482782944_496357423346018_5818268903424754264_n.jpg?stp=dst-jpg_s320x320_tt6&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHH_AuDym1_h_Gt35CeYD9UUv5wiBJykWgz0pzbdkl_7HVH1k09gFjEGZGaaanoHrw&_nc_ohc=UOwY1iuLY14Q7kNvwF6T6a4&_nc_gid=26ktQKWC9pWQuqHYOHHLSQ&edm=ACHbZRIBAAAA&ccb=7-5&oh=00_AfOxDHstKKV5WkD6-9aKBxJ0mTttI5R3bZ26ZQn9Mg84Og&oe=685A6928&_nc_sid=c024bc","width":320}],"is_verified":true,"profile_pic_id":"3583980709961915639_21393171","profile_pic_url":"https://scontent-lga3-2.cdninstagram.com/v/t51.2885-19/482782944_496357423346018_5818268903424754264_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHH_AuDym1_h_Gt35CeYD9UUv5wiBJykWgz0pzbdkl_7HVH1k09gFjEGZGaaanoHrw&_nc_ohc=UOwY1iuLY14Q7kNvwF6T6a4&_nc_gid=26ktQKWC9pWQuqHYOHHLSQ&edm=ACHbZRIBAAAA&ccb=7-5&oh=00_AfNtjn382KDVjtIjCSaHRLBv-5axcS6DArSz3ceqiChSQw&oe=685A6928&_nc_sid=c024bc","transparency_product_enabled":false,"username":"jane","is_embeds_disabled":false,"eligible_for_text_app_activation_badge":false},"image_versions2":{"additional_candidates":{"first_frame":{"height":1136,"url":"https://scontent-lga3-3.cdninstagram.com/v/t51.2885-15/501249811_1047509020812730_1368766689877144056_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLmltYWdlX3VybGdlbi42NDB4MTEzNi5zZHIuZjcxODc4LmFkZGl0aW9uYWxfY292ZXJfZnJhbWUifQ&_nc_ht=scontent-lga3-3.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2QHH_AuDym1_h_Gt35CeYD9UUv5wiBJykWgz0pzbdkl_7HVH1k09gFjEGZGaaanoHrw&_nc_ohc=33QsVTbubdAQ7kNvwG_XAXp&_nc_gid=26ktQKWC9pWQuqHYOHHLSQ&edm=ACHbZRIBAAAA&ccb=7-5&oh=00_AfOPIDhcaTvUglakLpfaFwY0VG7z_Q7Ua0cIZFWseBY6Iw&oe=685A6296&_nc_sid=c024bc","width":640},"igtv_first_frame":{"height":1136,"url":"https://scontent-lga3-3.cdninstagram.com/v/t51.2885-15/501249811_1047509020812730_1368766689877144056_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLmltYWdlX3VybGdlbi42NDB4MTEzNi5zZHIuZjcxODc4LmFkZGl0aW9uYWxfY292ZXJfZnJhbWUifQ&_nc_ht=scontent-lga3-3.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2QHH_AuDym1_h_Gt35CeYD9UUv5wiBJykWgz0pzbdkl_7HVH1k09gFjEGZGaaanoHrw&_nc_ohc=33QsVTbubdAQ7kNvwG_XAXp&_nc_gid=26ktQKWC9pWQuqHYOHHLSQ&edm=ACHbZRIBAAAA&ccb=7-5&oh=00_AfOPIDhcaTvUglakLpfaFwY0VG7z_Q7Ua0cIZFWseBY6Iw&oe=685A6296&_nc_sid=c024bc","width":640},"smart_frame":{"height":1920,"url":"https://scontent-lga3-2.cdninstagram.com/v/t15.5256-10/502085875_1788049852055333_7728247084856383096_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLmltYWdlX3VybGdlbi4xMDgweDE5MjAuc2RyLmY1MjU2LnN0YXRpY19zbWFydF90aHVtYm5haWxzOjpBTUxfTUxQX0hBTkRDUkFGVF9BTkRfWFJBWV9BRFNfQ1RSX0RJVkVSU0UifQ&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_cat=105&_nc_oc=Q6cZ2QHH_AuDym1_h_Gt35CeYD9UUv5wiBJykWgz0pzbdkl_7HVH1k09gFjEGZGaaanoHrw&_nc_ohc=jVe4YhB4hhcQ7kNvwHLLFGj&_nc_gid=26ktQKWC9pWQuqHYOHHLSQ&edm=ACHbZRIAAAAA&ccb=7-5&oh=00_AfPE2w7ZHuMdj6JkHfdN0ThY-Qfyhb8JZSwgO0jy3vknFw&oe=685A5983&_nc_sid=c024bc","width":1080}},"candidates":[{"height":2144,"url":"https://scontent-lga3-2.cdninstagram.com/v/t51.2885-15/501064973_18499642795017172_3156358348692457402_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLmltYWdlX3VybGdlbi4xMjA2eDIxNDQuc2RyLmY3NTc2MS5kZWZhdWx0X2NvdmVyX2ZyYW1lIn0&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHH_AuDym1_h_Gt35CeYD9UUv5wiBJykWgz0pzbdkl_7HVH1k09gFjEGZGaaanoHrw&_nc_ohc=nqrFLRdKJkgQ7kNvwFsYpnt&_nc_gid=26ktQKWC9pWQuqHYOHHLSQ&edm=ACHbZRIBAAAA&ccb=7-5&ig_cache_key=MzY0MTkyNDAyMzgyMDM1Njg2NjE4NDk5NjQyNzkyMDE3MTcy.3-ccb7-5&oh=00_AfOJFvfFxIS1SYZ5aZH9EoStYPO1y4sVrL_f18BDcI4gIA&oe=685A3C9E&_nc_sid=c024bc","width":1206}],"scrubber_spritesheet_info_candidates":{"default":{"file_size_kb":467,"max_thumbnails_per_sprite":105,"rendered_width":96,"sprite_height":1246,"sprite_urls":["https://scontent-lga3-2.cdninstagram.com/v/t51.2885-15/501930551_1739874873569815_2195383679016609522_n.jpg?_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QHH_AuDym1_h_Gt35CeYD9UUv5wiBJykWgz0pzbdkl_7HVH1k09gFjEGZGaaanoHrw&_nc_ohc=WQsolWkGTbEQ7kNvwGnCcen&_nc_gid=26ktQKWC9pWQuqHYOHHLSQ&edm=ACHbZRIBAAAA&ccb=7-5&oh=00_AfPA-bQmtGEM1tlWBC9ycNBKmLQXZ8HhuCQqTxZcKAwTNg&oe=685A34DF&_nc_sid=c024bc"],"sprite_width":1500,"thumbnail_duration":0.8703142857142857,"thumbnail_height":178,"thumbnail_width":100,"thumbnails_per_row":15,"total_thumbnail_num_per_sprite":105,"video_length":91.383}}},"url":"https://www.instagram.com/reel/DKKtpqaxg0C/"}],"max_id":"QVFEWFlDdGNOamdwbVdNM2pLY1NJRndSZ2tCbWp6WDV0TWxaYl9WNVktZU1BTUxWMlg1c2JFenNDanJVZ2NudWFjR28zRG93a3ByTExXaHJMbTA0aVJBZg=="},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/instagram/postDetail":{"post":{"operationId":"social_instagram_post_detail","x-nexscope-slug":"social-instagram-post-detail","summary":"Instagram Post/Reel Info","description":"Fetches detailed metadata for a single Instagram post or reel by shortcode or URL. Returns caption text, like count, comment count, video URL, video play count, video duration, display images, owner info, tagged users, carousel sidecar children when applicable, and the published time in `data.xdt_shortcode_media.created_at` as an ISO 8601 UTC date. The original Unix timestamp remains available in `data.xdt_shortcode_media.taken_at_timestamp`. Play counts are Instagram-only views and exclude cross-posted Facebook views. Set `include_play_count=false` to omit the play count and skip its additional fetch for a faster response.\n\nPlay counts can sometimes be inaccurate. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Post/Reel Info API View Pricing Get public post or reel details. Play counts may be inaccurate and exclude Facebook views. 1 credit per request\nSet to true to download the video/images and get back permanent Supabase URLs. Costs 10 credits if media is found, 1 credit otherwise.\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"url":{"type":"string","maxLength":2048,"minLength":1},"region":{"type":"string","description":"2 letter country code to set the proxy in"},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"},"download_media":{"type":"boolean","description":"Set to true to download the video/images and get back permanent Supabase URLs. Costs 10 credits if media is found, 1 credit otherwise."},"include_play_count":{"type":"boolean","description":"Set to false to omit `video_play_count` and skip its additional fetch for a faster response. Defaults to true."},"cacheMaxAge":{"enum":["1d","3d","7d","14d","30d"],"type":"string"}},"additionalProperties":false,"type":"object","required":["url"]},"example":{"url":"https://www.instagram.com/p/ABC123/"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"platform":{"enum":["instagram","youtube","reddit","pinterest"],"type":"string"},"resourceStatus":{"enum":["AVAILABLE","PARTIAL","PRIVATE","RESTRICTED","NOT_FOUND","NO_TRANSCRIPT","UNKNOWN"],"type":"string"},"fetchedAt":{"format":"date-time","type":"string"},"sourceFetchedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"usage":{"properties":{"billingStatus":{"enum":["NOT_CHARGED","SETTLED","UNKNOWN"],"type":"string"},"chargedCredits":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["billingStatus","chargedCredits"]},"item":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"likeCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"commentCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"viewCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"type":{"enum":["POST","REEL","UNKNOWN"],"type":"string"},"author":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","handle","name","url"]},{"type":"null"}]},"media":{"items":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"enum":["IMAGE","VIDEO","UNKNOWN"],"type":"string"},"thumbnailUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["url","type","thumbnailUrl"]},"type":"array"}},"additionalProperties":false,"type":"object","required":["id","url","caption","publishedAt","likeCount","commentCount","viewCount","type","author","media"]},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["platform","resourceStatus","fetchedAt","sourceFetchedAt","usage","item"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","resourceStatus":"NOT_FOUND","fetchedAt":"2026-10-28T00:00:00Z","sourceFetchedAt":null,"usage":{"billingStatus":"UNKNOWN","chargedCredits":null},"item":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/instagram/media/transcript":{"post":{"operationId":"social_instagram_media_transcript","x-nexscope-slug":"social-instagram-media-transcript","summary":"Instagram Transcript","description":"Generates AI speech-to-text for an Instagram video post or reel. Returns a transcripts array containing each video's id, shortcode, and text; no speech can produce null entries. Each result also includes transcripts[].transcript_with_timestamp: an array of {start: number, end: number, text: string} sentence/phrase segments, or null when speech or timing is unavailable. Times are seconds relative to each individual video, not the combined carousel. AI timings are approximate, not word-perfect. The existing text remains plain text. No new parameter is required, and pricing is unchanged. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. For carousels, default pricing stays flat 1 credit per request. With allow_long_transcription=true, sum 10 * ceil(duration_seconds / 60) for each successfully transcribed video, rather than rounding the combined duration; images and empty video transcripts have no AI fee. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Transcript API View Pricing Get AI transcripts with timestamp segments for videos in an Instagram post or reel. Long videos may time out. AI up to 2 minutes: 1 credit. Paid mode: 10 credits/minute, rounded up, even for short videos. No transcript: 0 credits.\nGenerates AI speech-to-text for an Instagram video post or reel. Returns a transcripts array containing each video's id, shortcode, and text; no speech can produce null entries. Each result also includes transcripts[].transcript_with_timestamp: an array of {start: number, end: number, text: string} sentence/phrase segments, or null when speech or timing is unavailable. Times are seconds relative to each individual video, not the combined carousel. AI timings are approximate, not word-perfect. The existing text remains plain text. No new parameter is required, and pricing is unchanged. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. For carousels, default pricing stays flat 1 credit per request. With allow_long_transcription=true, sum 10 * ceil(duration_seconds / 60) for each successfully transcribed video, rather than rounding the combined duration; images and empty video transcripts have no AI fee. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nPaid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (By default, successful AI up to 120 seconds costs a flat 1 credit per request; over 120 seconds requires allow_long_transcription=true, which bills ALL successful AI at 10 credits per started minute, including short videos; empty AI results and errors cost 0 credits). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Instagram post or reel URL"},"allow_long_transcription":{"type":"boolean","default":false,"description":"Paid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed."},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (By default, successful AI up to 120 seconds costs a flat 1 credit per request; over 120 seconds requires allow_long_transcription=true, which bills ALL successful AI at 10 credits per started minute, including short videos; empty AI results and errors cost 0 credits). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.instagram.com/reel/DYSaotKMSoY/"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","data":{"success":true,"transcripts":[{"id":"3597267389859272809","shortcode":"DHsD6HGqJhp","text":"Let's fry up the perfect bunzel. Beautiful.  Everybody, shh. The perfect bunzel. Let me show you my bunzel. When it comes down to bunzel, we make it the crispiest, get the crunch. Heaven.","transcript_with_timestamp":null}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/instagram/search":{"post":{"operationId":"social_instagram_search","x-nexscope-slug":"social-instagram-search","summary":"Instagram Search Instagram","description":"Use this for Instagram-native account, hashtag, or place lookup. It returns ranked users, hashtags, places, and keyword suggestions from Instagram itself. It is not Google-indexed, does not require an Instagram login, returns one page only, and does not return posts. For an Instagram-curated topic page with posts, use /v1/instagram/search/popular. For the same native account results in a profile-only response, use /v1/instagram/search/profiles. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Search Instagram API View Pricing Find users, hashtags, and places with Instagram search. Returns one page, without posts. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"The username, hashtag, place, or keyword to search for."}},"required":["query"],"additionalProperties":false},"example":{"query":"nike"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","data":{"success":true,"data":{"query":"nike","users":[{"position":0,"id":"13460080","username":"nike","full_name":"Nike","is_verified":true,"profile_pic_url":"https://instagram.example.com/nike.jpg"}],"hashtags":[{"position":2,"id":"17841562978125529","name":"nikewomen","media_count":2036828,"search_result_subtitle":null}],"places":[{"position":51,"id":"715603272","name":"Nike","title":"Nike","subtitle":"","facebook_places_id":"106068296090172"}],"keywords":[],"rank_token":"a6e9cded-6c3e-41be-a6b1-9fa5295a30d5"}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/instagram/search/popular":{"post":{"operationId":"social_instagram_search_popular","x-nexscope-slug":"social-instagram-search-popular","summary":"Instagram Popular Search","description":"Use this to explore an Instagram topic and the posts Instagram curates for it. It scrapes the public /popular/{query} page without requiring an Instagram login. The first page returns the topic title, numeric total media count, Instagram's generated description and sources, suggested terms, posts, and an opaque cursor. Pass that cursor with the same query to fetch more posts. Later pages return query, posts, cursor, and has_more only. For an exact hashtag through Google-indexed results, use /v1/instagram/search/hashtag. For reels only, use /v2/instagram/reels/search. Each successful request costs 1 credit. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Popular Search API View Pricing Explore an Instagram topic with its description, sources, suggested terms, media count, and paginated posts. 1 credit per request\nUse this to explore an Instagram topic and the posts Instagram curates for it. It scrapes the public /popular/{query} page without requiring an Instagram login. The first page returns the topic title, numeric total media count, Instagram's generated description and sources, suggested terms, posts, and an opaque cursor. Pass that cursor with the same query to fetch more posts. Later pages return query, posts, cursor, and has_more only. For an exact hashtag through Google-indexed results, use /v1/instagram/search/hashtag. For reels only, use /v2/instagram/reels/search. Each successful request costs 1 credit.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"The Popular topic to search for."},"cursor":{"type":"string","description":"The opaque cursor returned by the previous response. Use it with the same query to fetch the next page of posts."}},"required":["query"],"additionalProperties":false},"example":{"query":"basketball"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","data":{"success":true,"query":"basketball","title":"Basketball","total_media_count":8800000,"description":{"plain_text":"James Naismith invented basketball in December 1891 in Springfield, Massachusetts as an indoor winter activity.","source_uris":["https://en.wikipedia.org/wiki/Outline_of_basketball"],"linked_terms":[]},"suggested_terms":["the tallest basketball player"],"posts":[{"id":"POLARIS_3892957342260916992","shortcode":"DYGkBO3NfMA","url":"https://www.instagram.com/reel/DYGkBO3NfMA/","type":"reel","caption":"\uD83D\uDE02\uD83D\uDE02 #meta #pov #hooper #basketball","display_url":"https://instagram.example.com/basketball-cover.jpg","video_url":"https://instagram.example.com/basketball-video.mp4","play_count":11993988,"owner":{"id":"17841409679275910","username":"lukaceo","is_verified":false,"profile_pic_url":"https://instagram.example.com/lukaceo-profile.jpg"}}],"cursor":"opaque-cursor-from-response","has_more":true},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/instagram/search/hashtag":{"post":{"operationId":"social_instagram_search_hashtag","x-nexscope-slug":"social-instagram-search-hashtag","summary":"Instagram Search Hashtag Posts","description":"Use this when you know the exact hashtag and want Google-indexed public Instagram posts or reels, optional date filters, and pagination. It returns post details such as caption, engagement, owner, and post time. Results are best-effort and not a complete Instagram-native hashtag feed. For an Instagram-curated topic page with generated context and suggested terms, use /v1/instagram/search/popular. Pass media_type=reels to only return reels. Cursors are limited to pages 1 through 11; cursor 12 or greater returns a 400 response. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Search Hashtag Posts API View Pricing Find Google-indexed public posts by exact hashtag, with date filters and pagination. Results are best-effort, not a complete hashtag feed. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hashtag":{"type":"string","description":"The hashtag to search for. Include or omit the #."},"date_posted":{"type":"string","enum":["last-hour","last-day","last-week","last-month","last-year"],"description":"Only return Google-indexed posts found in this relative window."},"media_type":{"type":"string","enum":["all","reels"],"description":"Use all to search public posts and reels, or reels to only return reels. Defaults to all."},"cursor":{"type":"string","description":"The cursor returned by the previous response. It is the next Google results page number and cannot exceed 11; cursor 12 or greater returns a 400 response."}},"required":["hashtag"],"additionalProperties":false},"example":{"hashtag":"makeup"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","data":{"success":true,"hashtag":"funnydogs","media_type":"all","posts":[{"id":"3714950709444987377","__typename":"XDTGraphVideo","shortcode":"DOOJ_zSjcnx","url":"https://www.instagram.com/reel/DOOJ_zSjcnx/","caption":"Well we tried to be subtle…  #funnydogs #funny #whiteboxer #australianshepherd","thumbnail_src":"https://scontent-ord5-2.cdninstagram.com/v/t51.82787-15/542212527_18130644664455761_8262846918103190683_n.jpg?stp=c0.509.1312.1312a_dst-jpg_e35_s640x640_sh2.08_tt6&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_cat=105&_nc_oc=Q6cZ2gGAVcFN0K6MoOopK41K4dWjOeZZaT9xgOadaLiAbdnmQSVNlQgD_lz8yQLaXrtvYeY&_nc_ohc=eV6SPEh2O88Q7kNvwHcNeFx&_nc_gid=tAUZdiRnIdGjcNvGfTjMvg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_Af6BLCF7O_laTkSuoqn5Ebg8ZWg57JkaXtBAb6nH0KapPg&oe=6A1D1BB2&_nc_sid=d885a2","display_url":"https://scontent-ord5-2.cdninstagram.com/v/t51.82787-15/542212527_18130644664455761_8262846918103190683_n.jpg?stp=dst-jpg_e35_p1080x1080_sh2.08_tt6&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_cat=105&_nc_oc=Q6cZ2gGAVcFN0K6MoOopK41K4dWjOeZZaT9xgOadaLiAbdnmQSVNlQgD_lz8yQLaXrtvYeY&_nc_ohc=eV6SPEh2O88Q7kNvwHcNeFx&_nc_gid=tAUZdiRnIdGjcNvGfTjMvg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_Af6TdnB6cfe_BkRBRYP65isRGJfDrp2evUQY9O_ReUHv2g&oe=6A1D1BB2&_nc_sid=d885a2","video_url":"https://scontent-ord5-2.cdninstagram.com/o1/v/t2/f2/m86/AQNG_gCzevxl8xiNB2lVRlcV8c3o3r2ZyeLeWfaY4eaHdyRX3_Z1mty2jrHuH5Z66vTC5SXrhmpdG5re9MNyf1jCtWVyPKAWQFQ037o.mp4?_nc_cat=104&_nc_sid=5e9851&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_ohc=ByTiQjuOr9wQ7kNvwGpBh0x&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTEyMDQ3OTIyMDA0MTUwMSwiYXNzZXRfYWdlX2RheXMiOjI2NCwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjY1LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=638842146c84456b&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC80QTQ2OURBNUJBQTE1RjdFODZFRjQxRThCOUU1RTNBOV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC83NDQ4NjQwMTg0MjI1MjdfODI5Mjc2OTQ2ODc2ODI3MDk4OC5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmupyc3rzE_QMVAigCQzMsF0BQbul41P30GBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&_nc_gid=tAUZdiRnIdGjcNvGfTjMvg&_nc_ss=7a22e&_nc_zt=28&oh=00_Af6Z6PbM9b2RWG7EdCufc8MOp-pcmhJu3EMKtd_pzJaopw&oe=6A193955","has_audio":false,"accessibility_caption":null,"product_type":"clips","video_duration":65.733,"clips_music_attribution_info":{"artist_name":"_layla_the_boxer","song_name":"Original audio","uses_original_audio":true,"should_mute_audio":false,"should_mute_audio_reason":"","audio_id":"1303301604923923"},"is_video":true,"owner":{"id":"13582495760","username":"_layla_the_boxer","is_verified":true,"profile_pic_url":"https://scontent-ord5-3.cdninstagram.com/v/t51.2885-19/420493539_1460561894498614_4791883467164866946_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-ord5-3.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2gGAVcFN0K6MoOopK41K4dWjOeZZaT9xgOadaLiAbdnmQSVNlQgD_lz8yQLaXrtvYeY&_nc_ohc=aeHo4Q_mApIQ7kNvwERao4Z&_nc_gid=tAUZdiRnIdGjcNvGfTjMvg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_Af4Fxb_M04AcFcB7JVo3PYiMVir3WS0vIloaPKB0igyV_g&oe=6A1D1119&_nc_sid=d885a2","full_name":"Layla the Boxer","is_private":false,"is_unpublished":false,"follower_count":1369176,"post_count":1184},"taken_at":"2025-09-05T12:51:42.000Z","is_ad":false,"like_count":35854,"is_affiliate":false,"is_paid_partnership":false,"location":null,"comment_count":1263,"comments":[{"id":"18099897668494530","text":"\uD83D\uDE02\uD83D\uDE05\uD83E\uDD23\uD83D\uDE0D❤️\uD83E\uDD70","owner":{"id":"70821489119","is_verified":false,"profile_pic_url":"https://scontent-ord5-3.cdninstagram.com/v/t51.2885-19/466368394_545365701466258_2087161965910224562_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-ord5-3.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2gGAVcFN0K6MoOopK41K4dWjOeZZaT9xgOadaLiAbdnmQSVNlQgD_lz8yQLaXrtvYeY&_nc_ohc=JxQ38FoXdhsQ7kNvwH3PKC0&_nc_gid=tAUZdiRnIdGjcNvGfTjMvg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_Af5bZb_HVbD8jFTK8i271c6IoeUyGR3iiKL-YVd-tFY_Yw&oe=6A1D05C8&_nc_sid=d885a2","username":"jesshman66"},"like_count":0,"created_at":"2026-01-25T13:33:43.000Z"}]}],"cursor":"2"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/instagram/search/profiles":{"post":{"operationId":"social_instagram_search_profiles","x-nexscope-slug":"social-instagram-search-profiles","summary":"Instagram Search Instagram Profiles","description":"Use this for Instagram-native profile lookup. It returns every account in Instagram's first ranked native result set, then performs bounded best-effort enrichment for the first 10 accounts to preserve the previous profile fields such as biography, bio links, account flags, and follower/following/media counts. Results after the first 10 retain native ID, username, full name, verification status, profile photo, and URL, while unavailable detail fields are null or empty. It does not search Google-indexed bios or captions, Google title/description fields are null, and pagination is not supported. For users, hashtags, places, and keyword suggestions together, use /v1/instagram/search. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Search Instagram Profiles API View Pricing Find ranked profiles with Instagram search, without Google. No pagination; extra details for the first 10 results are best-effort. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"The profile name or username to search for."}},"required":["query"],"additionalProperties":false},"example":{"query":"fitness coach"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","data":{"success":true,"query":"hormozi","profiles":[{"id":"7547682342","username":"hormozi","full_name":"Alex Hormozi","biography":null,"bio_links":[],"external_url":null,"is_private":null,"is_verified":true,"is_business_account":null,"is_professional_account":null,"category_name":null,"profile_pic_url":"https://scontent.cdninstagram.com/v/t51.82787-19/example.jpg","follower_count":null,"following_count":null,"media_count":null,"url":"https://www.instagram.com/hormozi/","matched_from":"profile","google_title":null,"google_description":null}],"cursor":null},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/instagram/reelsSearch":{"post":{"operationId":"social_instagram_reels_search","x-nexscope-slug":"social-instagram-reels-search","summary":"Instagram Search Reels","description":"Use this when you only want Google-indexed Instagram reels matching a keyword or phrase, with optional date filters and pagination. It returns reel media, engagement, owner, location, and audio details. Results are best-effort rather than a complete Instagram-native search. For Instagram-curated topic posts, use /v1/instagram/search/popular. For an exact hashtag across posts and reels, use /v1/instagram/search/hashtag. Pages 1 through 11 are supported; page 12 or greater returns a 400 response. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Search Reels API View Pricing Find Google-indexed reels by keyword, with date filters and pagination. Results are best-effort, not a complete Instagram search. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keyword":{"type":"string","maxLength":1000,"minLength":1},"datePosted":{"enum":["last-week","last-month","last-year"],"type":"string"},"page":{"type":"integer","default":1,"maximum":11,"minimum":1}},"additionalProperties":false,"type":"object","required":["keyword"]},"example":{"keyword":"coffee"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"platform":{"enum":["instagram","youtube","reddit","pinterest"],"type":"string"},"resourceStatus":{"enum":["AVAILABLE","PARTIAL","PRIVATE","RESTRICTED","NOT_FOUND","NO_TRANSCRIPT","UNKNOWN"],"type":"string"},"fetchedAt":{"format":"date-time","type":"string"},"sourceFetchedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"usage":{"properties":{"billingStatus":{"enum":["NOT_CHARGED","SETTLED","UNKNOWN"],"type":"string"},"chargedCredits":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["billingStatus","chargedCredits"]},"items":{"items":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"likeCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"commentCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"viewCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"type":{"enum":["POST","REEL","UNKNOWN"],"type":"string"},"author":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","handle","name","url"]},{"type":"null"}]},"media":{"items":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"enum":["IMAGE","VIDEO","UNKNOWN"],"type":"string"},"thumbnailUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["url","type","thumbnailUrl"]},"type":"array"}},"additionalProperties":false,"type":"object","required":["id","url","caption","publishedAt","likeCount","commentCount","viewCount","type","author","media"]},"type":"array"},"page":{"maximum":11,"minimum":1,"type":"integer"},"nextPage":{"anyOf":[{"maximum":11,"minimum":2,"type":"integer"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"additionalProperties":false,"type":"object","required":["platform","resourceStatus","fetchedAt","sourceFetchedAt","usage","items","page","nextPage","hasMore"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","resourceStatus":"NOT_FOUND","fetchedAt":"2026-10-28T00:00:00Z","sourceFetchedAt":null,"usage":{"billingStatus":"UNKNOWN","chargedCredits":null},"items":[],"page":1,"nextPage":null,"hasMore":false},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/instagram/audio/reels":{"post":{"operationId":"social_instagram_audio_reels","x-nexscope-slug":"social-instagram-audio-reels","summary":"Instagram Get Reels By Audio Id","description":"Fetches the reels Instagram exposes for an audio page like instagram.com/reels/audio/{audio_id}/. Pass the audio_id from that URL. Use cursor from the previous response to request the next page when Instagram returns one. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Get Reels By Audio Id API View Pricing Get public reels associated with an Instagram audio ID. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"audio_id":{"type":"string","description":"The audio id from the Instagram audio page URL."},"cursor":{"type":"string","description":"Pagination cursor returned by Instagram from the previous response."}},"required":["audio_id"],"additionalProperties":false},"example":{"audio_id":"1392969992841787"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","data":{"success":true,"reels":[{"gen_ai_chat_with_ai_cta_info":null,"collaborator_edit_eligibility":false,"number_of_qualities":6,"related_ads_pivots_media_info":"USER_NOT_IN_TEST_GROUP","is_artist_pick":false,"translated_langs_for_autodub":[],"subtype_name_for_REST__":"XDTClipsMedia","is_eligible_for_poe":false,"original_lang_for_translations":"en","eligible_insights_entrypoints":"NONE","igbio_product":null,"hidden_likes_string_variant":-1,"is_social_ufi_disabled":false,"boost_unavailable_reason":null,"boost_unavailable_identifier":null,"boost_unavailable_reason_v2":[],"client_cache_key":"MzkxNDQ4MzYyNDQ0NjgzOTU0NQ==.3","can_reply":false,"photo_of_you":false,"media_attributions_data":[],"can_view_more_preview_comments":false,"mezql_token":"","has_tagged_users":false,"is_eligible_content_for_post_roll_ad":false,"is_cutout_sticker_allowed":false,"is_photo_comments_composer_enabled_for_author":false,"hide_view_all_comment_entrypoint":false,"has_liked":false,"is_organic_product_tagging_eligible":false,"view_state_item_type":128,"video_sticker_locales":[],"is_paid_partnership":false,"is_in_profile_grid":false,"is_tagged_media_shared_to_viewer_profile_grid":false,"should_show_author_pog_for_tagged_media_shared_to_profile_grid":false}],"cursor":"Gsbyq....","has_more":true},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/instagram/reels/trending":{"post":{"operationId":"social_instagram_reels_trending","x-nexscope-slug":"social-instagram-reels-trending","summary":"Instagram Trending Reels","description":"Discovers reels through Instagram's public Popular pages and current featured topics, with pagination handled internally. Each reel's actual publication timestamp is checked: posts older than seven days, posts with unavailable dates, and unavailable posts are excluded. Results are deduplicated within each response and ordered by available play counts. This is recent popular-Reels discovery, not Instagram's official global trending ranking or a measure of view growth. Returns up to 12 reels, and repeated calls can overlap. Returns `reels` with shortcode, URL, caption, publication date, media URLs, available engagement counts, and user info. Missing engagement counts may be null. Successful requests cost one credit; if Instagram supplies too few verified recent reels, the endpoint returns an uncharged 503 rather than including older posts. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Trending Reels API View Pricing Get popular reels from the last seven days, not an official global ranking. Results can repeat across calls; too few verified recent reels cause an uncharged 503. 1 credit per request\nDiscovers reels through Instagram's public Popular pages and current featured topics, with pagination handled internally. Each reel's actual publication timestamp is checked: posts older than seven days, posts with unavailable dates, and unavailable posts are excluded. Results are deduplicated within each response and ordered by available play counts. This is recent popular-Reels discovery, not Instagram's official global trending ranking or a measure of view growth. Returns up to 12 reels, and repeated calls can overlap. Returns `reels` with shortcode, URL, caption, publication date, media URLs, available engagement counts, and user info. Missing engagement counts may be null. Successful requests cost one credit; if Instagram supplies too few verified recent reels, the endpoint returns an uncharged 503 rather than including older posts.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"example":{}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","data":{"success":true,"reels":[{"id":"4000819054877393649","pk":"4000819054877393649","shortcode":"DeFw7uwlMLx","url":"https://www.instagram.com/reel/DeFw7uwlMLx/","caption":"Impatiently waiting for #UFC335...\n\nThe countdown is on to @CharlesDoBronxs vs @DiegoLopesMMA\n\n[ LIVE DEC 12 on @ParamountPlus ]","taken_at":"2026-10-04T23:00:03.000Z","media_type":2,"product_type":"clips","video_url":"https://scontent.cdninstagram.com/example.mp4","video_versions":[{"type":101,"url":"https://scontent.cdninstagram.com/example.mp4"}],"image_url":"https://scontent.cdninstagram.com/example.jpg","image_versions2":{"additional_candidates":{"first_frame":{"url":"https://scontent.cdninstagram.com/example.jpg"}},"candidates":[{"url":"https://scontent.cdninstagram.com/example.jpg","height":1920,"width":1080}]},"original_width":1080,"original_height":1920,"has_audio":true,"like_count":423127,"comment_count":1623,"play_count":5112349,"ig_play_count":null,"clips_metadata":{"music_info":null,"original_sound_info":{"audio_asset_id":"28770083305965221","original_audio_title":"Original audio","ig_artist":{"username":"ufc","id":"22832340"},"is_explicit":false,"should_mute_audio":false,"consumption_info":{"should_mute_audio_reason":"","is_trending_in_clips":false},"audio_filter_infos":null}},"user":{"id":"17841401450200356","pk":"22832340","username":"ufc","full_name":"UFC","profile_pic_url":"https://scontent.cdninstagram.com/example.jpg","is_verified":true,"is_private":false}}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/instagram/post/comments":{"post":{"operationId":"social_instagram_post_comments","x-nexscope-slug":"social-instagram-post-comments","summary":"Instagram Comments","description":"Retrieves comments on a public Instagram post or reel. Each comment includes the comment text, creation timestamp, reply count when Instagram provides it, and commenter details such as username, user ID, verification status, and profile picture URL. `child_comment_count` can be null when Instagram does not expose the count publicly. Set `include_replies=true` to fetch the first page of replies for every returned comment. This adds `replies`, `replies_cursor`, and `has_more_replies` to each comment. Successful pages with `comments: []` cost 0 credits, even with `include_replies=true`. Pages with comments cost 1 credit, or 15 credits with `include_replies=true`, even if no replies are returned. Errors are not charged. This option is much slower than a normal comments request and may time out at 29 seconds. Supports cursor-based pagination to load additional comment pages.\n\nYou should expect ~90% success rate. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Comments API View Pricing Get post or reel comments; expect about 90% success. Pages with comments cost 1 credit, or 15 with include_replies=true. Empty pages and errors cost 0 credits. 1 credit per request\nRetrieves comments on a public Instagram post or reel. Each comment includes the comment text, creation timestamp, reply count when Instagram provides it, and commenter details such as username, user ID, verification status, and profile picture URL. `child_comment_count` can be null when Instagram does not expose the count publicly. Set `include_replies=true` to fetch the first page of replies for every returned comment. This adds `replies`, `replies_cursor`, and `has_more_replies` to each comment. Successful pages with `comments: []` cost 0 credits, even with `include_replies=true`. Pages with comments cost 1 credit, or 15 credits with `include_replies=true`, even if no replies are returned. Errors are not charged. This option is much slower than a normal comments request and may time out at 29 seconds. Supports cursor-based pagination to load additional comment pages.\n\nYou should expect ~90% success rate.\nSet to true to include replies for every returned comment. Costs 15 credits when comments are returned, even if no replies are found; successful pages with no comments cost 0 credits. This is much slower and may time out at 29 seconds.\nComments returned: 1 credit normally, 15 total with include_replies=true even without replies. Empty pages and errors 0.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the post or reel to get comments from"},"include_replies":{"type":"boolean","description":"Set to true to include replies for every returned comment. Costs 15 credits when comments are returned, even if no replies are found; successful pages with no comments cost 0 credits. This is much slower and may time out at 29 seconds."},"cursor":{"type":"string","description":"The cursor to get more comments. Get 'cursor' from previous response."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.instagram.com/reel/DOq6eV6iIgD"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","data":{"success":true,"comments":[{"id":"18051843701642870","text":"\"...but who wants to know people who don't love animals anyway?\". ❤️","created_at":"2025-09-16T17:03:04.000Z","comment_like_count":0,"child_comment_count":0,"replies":[],"replies_cursor":null,"has_more_replies":false,"user":{"is_verified":false,"id":"46773599357","pk":"46773599357","is_unpublished":null,"profile_pic_url":"https://scontent-dfw5-1.cdninstagram.com/v/t51.2885-19/542013919_18051324464559358_4060586438619554592_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2QEVOAPWq7DXE6cVfhoMQb0GTMvPo_vizELP9TUgQylvA5jBW1WSonDzvjeTQpAGJ3w&_nc_ohc=b__bzrMG6kYQ7kNvwGXM67R&_nc_gid=oDBffhoPbGLAq2tbCGpGKg&edm=AKp6CbIBAAAA&ccb=7-5&oh=00_AflThVwZ86n6DiACA5-zJCNFQZWBwHfaG6AXZclgea57BA&oe=695A3139&_nc_sid=d62176","username":"catherina_thijs","fbid_v2":"17841446780736699"}}],"cursor":"AQHSpoi6HyDbzYRMzrD........."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/instagram/post/comment/replies":{"post":{"operationId":"social_instagram_post_comment_replies","x-nexscope-slug":"social-instagram-post-comment-replies","summary":"Instagram Comment Replies","description":"Retrieves the public replies to a specific Instagram comment. Pass the post or reel URL and the parent comment's `id` from the Comments endpoint. Returns reply text, timestamps, engagement counts, parent comment ID, and user details. Paginate with `cursor` when `has_more` is true. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Comment Replies API View Pricing Get replies to an Instagram comment. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The Instagram post or reel URL"},"comment_id":{"type":"string","description":"The parent comment ID from the Comments endpoint"},"cursor":{"type":"string","description":"The cursor to get more replies. Get `cursor` from the previous response."}},"required":["url","comment_id"],"additionalProperties":false},"example":{"url":"https://www.instagram.com/reel/C8rKmYvsrck","comment_id":"18038110327814211"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","data":{"success":true,"comments":[{"id":"18277034998224667","text":"@username Thanks for the reply!","comment_like_count":null,"child_comment_count":0,"created_at":"2024-06-28T06:20:32.000Z","parent_comment_id":"18038110327814211","user":{"id":"25621023419","pk":"25621023419","username":"username","is_verified":false,"profile_pic_url":"https://instagram.fosu2-2.fna.fbcdn.net/....jpg"}}],"cursor":null,"has_more":false},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/instagram/user/highlights":{"post":{"operationId":"social_instagram_user_highlights","x-nexscope-slug":"social-instagram-user-highlights","summary":"Instagram Story Highlights","description":"Returns up to 10 story highlight albums visible on Instagram without signing in. This is the available logged-out list, not a guarantee of every highlight on the account. Pagination is not available. Each highlight includes its ID, title, cropped cover URL, and owner info with username and profile picture. The full-size cover_media.thumbnail_src field is null because Instagram does not supply it; use cover_media_cropped_thumbnail.url for the available cover image. Accepts either a user_id or handle; providing user_id yields faster responses. If Instagram explicitly blocks handle lookup, age restrictions return HTTP 403 with message 'Profile is age restricted'; restricted profiles return HTTP 404 with message 'Profile is restricted'; confirmed unavailable profiles return HTTP 404 with message 'Profile is unavailable on Instagram'. These responses keep success: true to indicate a confirmed profile state, include an error field, and charge no credits. Check the HTTP status and error field, not success alone. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Story Highlights API View Pricing Get up to 10 story highlights visible without signing in. No pagination. Cropped covers are available; full-size covers are null. 1 credit per request\nReturns up to 10 story highlight albums visible on Instagram without signing in. This is the available logged-out list, not a guarantee of every highlight on the account. Pagination is not available. Each highlight includes its ID, title, cropped cover URL, and owner info with username and profile picture. The full-size cover_media.thumbnail_src field is null because Instagram does not supply it; use cover_media_cropped_thumbnail.url for the available cover image. Accepts either a user_id or handle; providing user_id yields faster responses. If Instagram explicitly blocks handle lookup, age restrictions return HTTP 403 with message 'Profile is age restricted'; restricted profiles return HTTP 404 with message 'Profile is restricted'; confirmed unavailable profiles return HTTP 404 with message 'Profile is unavailable on Instagram'. These responses keep success: true to indicate a confirmed profile state, include an error field, and charge no credits. Check the HTTP status and error field, not success alone.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string","description":"Instagram user id. Use for faster response times."},"handle":{"type":"string","description":"Instagram handle. Use user_id for faster response times."}},"required":[],"additionalProperties":false},"example":{"handle":"jane"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","data":{"success":true,"highlights":[{"__typename":"GraphHighlightReel","id":"18067016518767507","cover_media":{"thumbnail_src":null},"cover_media_cropped_thumbnail":{"url":"https://scontent-atl3-1.cdninstagram.com/v/t51.2885-15/479737232_1405856350793820_7928432152706230890_n.jpg?stp=c0.202.640.640a_dst-jpg_e15_s150x150_tt6&_nc_ht=scontent-atl3-1.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2QFp33CnPIjTITbJL483a_ZGgbaCZ_M2CLjXKDaTtNtjnH0vMIJHdZhYlMp8pitL7H0&_nc_ohc=yQlHN7CDZ7IQ7kNvwFL7xsz&_nc_gid=_FojUPY_PyEb8t9oWJExMQ&edm=AGW0Xe4BAAAA&ccb=7-5&oh=00_AfL4zidNtWdVh-3T2E2qOiLS4ks_Z9UbmTSFbCX3SFmbBg&oe=682184F5&_nc_sid=94fea1"},"owner":{"__typename":"GraphUser","id":"21393171","profile_pic_url":"https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/482782944_496357423346018_5818268903424754264_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QFp33CnPIjTITbJL483a_ZGgbaCZ_M2CLjXKDaTtNtjnH0vMIJHdZhYlMp8pitL7H0&_nc_ohc=mi86alqirjwQ7kNvwHuN1wX&_nc_gid=_FojUPY_PyEb8t9oWJExMQ&edm=AGW0Xe4BAAAA&ccb=7-5&oh=00_AfLoz8BQ5BXQz1Wm0goIWDxkdw5Z1aNbJGXk8ak6YZ8pzQ&oe=68218068&_nc_sid=94fea1","username":"jane"},"title":"GRWM chats"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/instagram/user/highlight/detail":{"post":{"operationId":"social_instagram_user_highlight_detail","x-nexscope-slug":"social-instagram-user-highlight-detail","summary":"Instagram Highlights Details","description":"Fetches the full contents of a specific Instagram story highlight album by its ID. Returns the highlight's cover image, title, user info, and an items array containing each story with its media type, image or video URLs, dimensions, timestamp, and sticker/interactive element data. Useful for archiving or analyzing individual highlight reels. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Highlights Details API View Pricing Get a story highlight's details and stories. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the highlight to get details for"}},"required":[],"additionalProperties":false},"example":{"id":"18067016518767507"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","data":{"success":true,"id":"highlight:18067016518767507","latest_reel_media":1745272279,"seen":null,"can_reply":false,"can_gif_quick_reply":true,"can_reshare":true,"reel_type":"highlight_reel","ad_expiry_timestamp_in_millis":null,"is_cta_sticker_available":null,"app_sticker_info":null,"should_treat_link_sticker_as_cta":null,"pool_refresh_ttl_in_sec":null,"can_react_with_avatar":false,"cover_media":{"cropped_image_version":{"width":150,"height":150,"url":"https://scontent-dub4-1.cdninstagram.com/v/t51.2885-15/479737232_1405856350793820_7928432152706230890_n.jpg?stp=c0.202.640.640a_dst-jpg_e15_s150x150_tt6&_nc_ht=scontent-dub4-1.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2QGmly2VJEPPnYd3yasHydMcSwfCazUKlRXiU5HUJ-zQVPrC9Xb-ho-EFRAjvcUgWnY&_nc_ohc=yQlHN7CDZ7IQ7kNvwFIJktj&_nc_gid=-RHeydtWtdTLhayCKiI3oQ&edm=ANmP7GQBAAAA&ccb=7-5&oh=00_AfKKWP06eveppAsTaksGtYoLYb_lesIro1a34w-gEGgJ8A&oe=682184F5&_nc_sid=982cc7","scans_profile":""},"crop_rect":[0],"media_id":"3574665805209826888_21393171","full_image_version":null,"upload_id":null},"user":{"pk":"21393171","pk_id":"21393171","full_name":"Jane Williamson","is_private":false,"strong_id__":"21393171","id":"21393171","username":"jane","is_verified":true,"profile_pic_id":"3583980709961915639_21393171","profile_pic_url":"https://scontent-dub4-1.cdninstagram.com/v/t51.2885-19/482782944_496357423346018_5818268903424754264_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-dub4-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QGmly2VJEPPnYd3yasHydMcSwfCazUKlRXiU5HUJ-zQVPrC9Xb-ho-EFRAjvcUgWnY&_nc_ohc=mi86alqirjwQ7kNvwFr3H5A&_nc_gid=-RHeydtWtdTLhayCKiI3oQ&edm=ANmP7GQBAAAA&ccb=7-5&oh=00_AfIKcWUsUpfsBZW0eePl0Z6La3wJHY0FPIj7QRpbwooklA&oe=68218068&_nc_sid=982cc7","interop_messaging_user_fbid":119713162748634,"transparency_product_enabled":false},"items":[{"pk":"3565907942018983442","id":"3565907942018983442_21393171","is_visual_reply_commenter_notice_enabled":true,"like_and_view_counts_disabled":false,"is_post_live_clips_media":false,"is_reshare_of_text_post_app_media_in_ig":false,"is_reel_media":true,"fbid":"17968033766718273","device_timestamp":1739309362129426,"caption_is_edited":false,"strong_id__":"3565907942018983442_21393171","is_quicksnap_recap":false,"deleted_reason":0,"mezql_token":"","imported_taken_at":1739305646,"should_request_ads":false,"is_terminal_video_segment":false,"integrity_review_decision":"pending","client_cache_key":"MzU2NTkwNzk0MjAxODk4MzQ0Mg==.3","comment_threading_enabled":true,"is_unified_video":false,"commerciality_status":"not_commercial","caption_position":0,"has_privately_liked":false,"filter_type":0,"taken_at":1739309361,"hide_view_all_comment_entrypoint":false,"is_comments_gif_composer_enabled":false,"video_sticker_locales":[],"is_dash_eligible":1,"video_dash_manifest":"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<MPD xmlns=\"urn:mpeg:dash:schema:mpd:2011\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:schemaLocation=\"urn:mpeg:dash:schema:mpd:2011 DASH-MPD.xsd\" profiles=\"urn:mpeg:dash:profile:isoff-on-demand:2011\" minBufferTime=\"PT2S\" type=\"static\" mediaPresentationDuration=\"PT55.866665S\" FBManifestIdentifier=\"FgAYEWlnX2Rhc2hfYmFzaWNfdnA5GVakidDNlteaArDgzvCy78QDoofA1en7zAOewtDZrN6hBPqfhZ22qqYiIhgYZGFzaF9sbl9oZWFhY192YnIzX2F1ZGlvIgA=\"><Period id=\"0\" duration=\"PT55.866665S\"><AdaptationSet id=\"0\" contentType=\"video\" subsegmentAlignment=\"true\" par=\"9:16\" FBUnifiedUploadResolutionMos=\"360:87.8\"><Representation id=\"1013678003978705vd\" bandwidth=\"442825\" codecs=\"vp09.00.21.08.01.01.01.01.00\" mimeType=\"video/mp4\" sar=\"1:1\" FBEncodingTag=\"dash_vp9-basic-gen2_360p\" FBContentLength=\"3092396\" FBPlaybackResolutionMos=\"0:100,360:76.2,480:68.3,720:55.5,1080:42.6\" FBPlaybackResolutionMosConfidenceLevel=\"high\" FBPlaybackResolutionCsvqm=\"0:100,360:90.6,480:83.1,720:70.6,1080:57.1\" width=\"360\" height=\"640\" frameRate=\"15360/512\" FBDefaultQuality=\"1\" FBQualityClass=\"sd\" FBQualityLabel=\"360p\"><BaseURL>https://scontent-dub4-1.cdninstagram.com/o1/v/t2/f2/m367/AQOfoUrcpLyCypvA0r8KJNYVZqRMK_xKgHt6BIIR-2d-pZc8HrSUxb_ADpVH2fHJ_Jga14in9wNDQMKL8YmnSyh2SyuBIi1wH-0GagOjJyNiPExeppA3tiJXWvimPCV3DixoO1Bq.mp4?_nc_cat=108&amp;_nc_sid=9ca052&amp;_nc_ht=scontent-dub4-1.cdninstagram.com&amp;_nc_ohc=jqHP6zi0XkIQ7kNvwHHEdKy&amp;efg=eyJ2ZW5jb2RlX3RhZyI6ImlnLXhwdmRzLnN0b3J5LmMyLUMzLmRhc2hfdnA5LWJhc2ljLWdlbjJfMzYwcCIsInZpZGVvX2lkIjpudWxsLCJvaWxfdXJsZ2VuX2FwcF9pZCI6OTM2NjE5NzQzMzkyNDU5LCJjbGllbnRfbmFtZSI6ImlnIiwieHB2X2Fzc2V0X2lkIjoxMzc3ODEwOTUzMzg3NzQ2LCJ2aV91c2VjYXNlX2lkIjoxMDEwMCwiZHVyYXRpb25fcyI6NTUsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&amp;ccb=17-1&amp;_nc_zt=28&amp;oh=00_AfJeY5DgeknyRN-Oj5qSXRKzB0wL9yWYB4PyUjf9wvqfgQ&amp;oe=682162E0</BaseURL><SegmentBase indexRange=\"818-993\" timescale=\"15360\" FBMinimumPrefetchRange=\"994-24037\" FBFirstSegmentRange=\"994-284754\" FBFirstSegmentDuration=\"5000\" FBSecondSegmentRange=\"284755-582397\" FBPrefetchSegmentRange=\"994-284754\" FBPrefetchSegmentDuration=\"5000\"><Initialization range=\"0-817\"/></SegmentBase></Representation><Representation id=\"621622240870994v\" bandwidth=\"1213073\" codecs=\"vp09.00.30.08.01.01.01.01.00\" mimeType=\"video/mp4\" sar=\"1:1\" FBEncodingTag=\"dash_vp9-basic-gen2_540p\" FBContentLength=\"8471295\" FBPlaybackResolutionMos=\"0:100,360:88.4,480:83.5,720:75.1,1080:65\" FBPlaybackResolutionMosConfidenceLevel=\"high\" FBPlaybackResolutionCsvqm=\"0:100,360:96,480:94.4,720:89.5,1080:80.1\" width=\"540\" height=\"960\" frameRate=\"15360/512\" FBQualityClass=\"sd\" FBQualityLabel=\"540p\"><BaseURL>https://scontent-dub4-1.cdninstagram.com/o1/v/t2/f2/m367/AQNVYK_LcjKX7BfZe6teyHabLQAnRYyvQ0OaomvrOYVCPI39q3Mua18SLdXRP1rLDAWZtmaw0daxwozitRR7QuRlk-yu0u6aNkSo6bVRxWiHWJMrsuFUpZ3wEXzsglQDn__HYhrE.mp4?_nc_cat=101&amp;_nc_sid=9ca052&amp;_nc_ht=scontent-dub4-1.cdninstagram.com&amp;_nc_ohc=YsOmqegW-HAQ7kNvwHvk5t6&amp;efg=eyJ2ZW5jb2RlX3RhZyI6ImlnLXhwdmRzLnN0b3J5LmMyLUMzLmRhc2hfdnA5LWJhc2ljLWdlbjJfNTQwcCIsInZpZGVvX2lkIjpudWxsLCJvaWxfdXJsZ2VuX2FwcF9pZCI6OTM2NjE5NzQzMzkyNDU5LCJjbGllbnRfbmFtZSI6ImlnIiwieHB2X2Fzc2V0X2lkIjoxMzc3ODEwOTUzMzg3NzQ2LCJ2aV91c2VjYXNlX2lkIjoxMDEwMCwiZHVyYXRpb25fcyI6NTUsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&amp;ccb=17-1&amp;_nc_zt=28&amp;oh=00_AfJClU-cSxarTYZZelf4X843_PLNlpHXaOVA8JeQ4P6KjA&amp;oe=682163B3</BaseURL><SegmentBase indexRange=\"818-993\" timescale=\"15360\" FBMinimumPrefetchRange=\"994-47780\" FBFirstSegmentRange=\"994-766720\" FBFirstSegmentDuration=\"5000\" FBSecondSegmentRange=\"766721-1575879\" FBPrefetchSegmentRange=\"994-766720\" FBPrefetchSegmentDuration=\"5000\"><Initialization range=\"0-817\"/></SegmentBase></Representation><Representation id=\"1200088581542031v\" bandwidth=\"2208026\" codecs=\"vp09.00.31.08.01.01.01.01.00\" mimeType=\"video/mp4\" sar=\"1:1\" FBEncodingTag=\"dash_vp9-basic-gen2_720p\" FBContentLength=\"15419382\" FBPlaybackResolutionMos=\"0:100,360:93.3,480:90.1,720:83,1080:71.9\" FBPlaybackResolutionMosConfidenceLevel=\"high\" FBPlaybackResolutionCsvqm=\"0:100,360:97.5,480:96.5,720:94.3,1080:86.5\" width=\"720\" height=\"1280\" frameRate=\"15360/512\" FBQualityClass=\"hd\" FBQualityLabel=\"720p\"><BaseURL>https://scontent-dub4-1.cdninstagram.com/o1/v/t2/f2/m367/AQMZ2fGGIbfKfEB8WZCN2uo1kyDrbZSRTuS9NuKQsm1kdrgBwIgx5uTkgSSwSrg-HwQGBXwyIV6JLLFGIHufr1R3biAaDoj6ef07ZsEglx5OkMyyYPdnMGzVR8ssmYaKJyFG6xTa.mp4?_nc_cat=101&amp;_nc_sid=9ca052&amp;_nc_ht=scontent-dub4-1.cdninstagram.com&amp;_nc_ohc=ZnDVAwVn1J0Q7kNvwFP3y7A&amp;efg=eyJ2ZW5jb2RlX3RhZyI6ImlnLXhwdmRzLnN0b3J5LmMyLUMzLmRhc2hfdnA5LWJhc2ljLWdlbjJfNzIwcCIsInZpZGVvX2lkIjpudWxsLCJvaWxfdXJsZ2VuX2FwcF9pZCI6OTM2NjE5NzQzMzkyNDU5LCJjbGllbnRfbmFtZSI6ImlnIiwieHB2X2Fzc2V0X2lkIjoxMzc3ODEwOTUzMzg3NzQ2LCJ2aV91c2VjYXNlX2lkIjoxMDEwMCwiZHVyYXRpb25fcyI6NTUsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&amp;ccb=17-1&amp;_nc_zt=28&amp;oh=00_AfJI3HBj5B_USsbfjD3mig9BmKADRB-WNgDkLiSNcA9AXg&amp;oe=6821608B</BaseURL><SegmentBase indexRange=\"818-993\" timescale=\"15360\" FBMinimumPrefetchRange=\"994-70338\" FBFirstSegmentRange=\"994-1348250\" FBFirstSegmentDuration=\"5000\" FBSecondSegmentRange=\"1348251-2820412\" FBPrefetchSegmentRange=\"994-1348250\" FBPrefetchSegmentDuration=\"5000\"><Initialization range=\"0-817\"/></SegmentBase></Representation><Representation id=\"995872305960984v\" bandwidth=\"2923144\" codecs=\"vp09.00.40.08.01.01.01.01.00\" mimeType=\"video/mp4\" sar=\"1:1\" FBEncodingTag=\"dash_vp9-basic-gen2_1080p\" FBContentLength=\"20413296\" FBPlaybackResolutionMos=\"0:100,360:94.2,480:92.6,720:86.7,1080:78.6\" FBPlaybackResolutionMosConfidenceLevel=\"high\" FBPlaybackResolutionCsvqm=\"0:100,360:97.9,480:97.2,720:95.5,1080:92.4\" width=\"1080\" height=\"1920\" frameRate=\"15360/512\" FBQualityClass=\"hd\" FBQualityLabel=\"1080p\"><BaseURL>https://scontent-dub4-1.cdninstagram.com/o1/v/t2/f2/m367/AQPnP3tyR_xd5vqiR9rHqL4uKAjCLDaAYc0d8G15LFH4_WgzATFrwGXbO3j9AFBXxW_dMMt-bIcZjhcDf9KdKZVBXZfKTpq4NqOdhEyNtKMfJi0pduOiR8a2SGkol-VtVBcSU7y0ow.mp4?_nc_cat=106&amp;_nc_sid=9ca052&amp;_nc_ht=scontent-dub4-1.cdninstagram.com&amp;_nc_ohc=Xh9mj1ql7FsQ7kNvwGfdBze&amp;efg=eyJ2ZW5jb2RlX3RhZyI6ImlnLXhwdmRzLnN0b3J5LmMyLUMzLmRhc2hfdnA5LWJhc2ljLWdlbjJfMTA4MHAiLCJ2aWRlb19pZCI6bnVsbCwib2lsX3VybGdlbl9hcHBfaWQiOjkzNjYxOTc0MzM5MjQ1OSwiY2xpZW50X25hbWUiOiJpZyIsInhwdl9hc3NldF9pZCI6MTM3NzgxMDk1MzM4Nzc0NiwidmlfdXNlY2FzZV9pZCI6MTAxMDAsImR1cmF0aW9uX3MiOjU1LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&amp;ccb=17-1&amp;_nc_zt=28&amp;oh=00_AfIPo5nYW_cUOteJVej4-Or_9EsE1QoCPgFvyhr3gWNKbQ&amp;oe=68217548</BaseURL><SegmentBase indexRange=\"818-993\" timescale=\"15360\" FBMinimumPrefetchRange=\"994-82033\" FBFirstSegmentRange=\"994-1794971\" FBFirstSegmentDuration=\"5000\" FBSecondSegmentRange=\"1794972-3714039\" FBPrefetchSegmentRange=\"994-1794971\" FBPrefetchSegmentDuration=\"5000\"><Initialization range=\"0-817\"/></SegmentBase></Representation></AdaptationSet><AdaptationSet id=\"1\" contentType=\"audio\" subsegmentStartsWithSAP=\"1\" subsegmentAlignment=\"true\"><Representation id=\"9654440924588029ad\" bandwidth=\"84784\" codecs=\"mp4a.40.5\" mimeType=\"audio/mp4\" FBAvgBitrate=\"84784\" audioSamplingRate=\"44100\" FBEncodingTag=\"dash_ln_heaac_vbr3_audio\" FBContentLength=\"593255\" FBPaqMos=\"67.44\" FBDefaultQuality=\"1\"><AudioChannelConfiguration schemeIdUri=\"urn:mpeg:dash:23003:3:audio_channel_configuration:2011\" value=\"2\"/><BaseURL>https://scontent-dub4-1.cdninstagram.com/o1/v/t16/f2/m69/AQNyWBRlKnroBxnnX-EpqgZgFfAyiJwI-Shbf9Eq1B1Ma9Pxo26PXQBrs_bIP7SJepuJU3-Yyr9hBKTg1ksLVc5x.mp4?strext=1&amp;_nc_cat=107&amp;_nc_sid=9ca052&amp;_nc_ht=scontent-dub4-1.cdninstagram.com&amp;_nc_ohc=asFzHjDcgjkQ7kNvwGBmUxq&amp;efg=eyJ2ZW5jb2RlX3RhZyI6ImlnLXhwdmRzLnN0b3J5LmMyLUMzLmRhc2hfbG5faGVhYWNfdmJyM19hdWRpbyIsInZpZGVvX2lkIjpudWxsLCJvaWxfdXJsZ2VuX2FwcF9pZCI6OTM2NjE5NzQzMzkyNDU5LCJjbGllbnRfbmFtZSI6ImlnIiwieHB2X2Fzc2V0X2lkIjoxMzc3ODEwOTUzMzg3NzQ2LCJ2aV91c2VjYXNlX2lkIjoxMDEwMCwiZHVyYXRpb25fcyI6NTUsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&amp;ccb=17-1&amp;_nc_zt=28&amp;oh=00_AfI_TGV4rJPmSPk3Kr05twnv4TiuERYpk8DZGhIPelmVBg&amp;oe=68216059</BaseURL><SegmentBase indexRange=\"824-1191\" timescale=\"44100\" FBMinimumPrefetchRange=\"1192-1535\" FBFirstSegmentRange=\"1192-24804\" FBFirstSegmentDuration=\"2021\" FBSecondSegmentRange=\"24805-45822\" FBPrefetchSegmentRange=\"1192-45822\" FBPrefetchSegmentDuration=\"4017\"><Initialization range=\"0-823\"/></SegmentBase></Representation></AdaptationSet></Period></MPD>\n","number_of_qualities":4,"video_versions":[{"bandwidth":null,"height":852,"type":101,"url":"https://scontent-dub4-1.cdninstagram.com/o1/v/t16/f2/m78/AQN5lthB7AgZeog8GcsUwAQtYg4PrP5y41v_bUs-ydLXFkg6cTCxlHYvYO9pyOGdbZ_h0iB8TpaRmEFn7KAjENMlWQGfsqMod9-9hpU.mp4?stp=dst-mp4&efg=eyJxZV9ncm91cHMiOiJbXCJpZ193ZWJfZGVsaXZlcnlfdnRzX290ZlwiXSIsInZlbmNvZGVfdGFnIjoidnRzX3ZvZF91cmxnZW4uc3RvcnkuYzIuNzIwLmJhc2VsaW5lIn0&_nc_cat=109&vs=622357473721923_1538615199&_nc_vs=HBksFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0EwNEZFM0FDNjFERDBFRDJCNEM3MzVENDg5Rjg0MUIwX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBABUCGDpwYXNzdGhyb3VnaF9ldmVyc3RvcmUvR0FBRlp4eFJSZ1RQaHJnRUFKMlFxRUgyOGE4dmJwa3dBQUFGFQICyAEAKAAYABsBiAd1c2Vfb2lsATEVAAAmmOLA9%2FDQi0AVAigCQzMsF0BL7tkWhysCGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHXoB2XonQEA&_nc_rid=e09fae6dc1&ccb=9-4&oh=00_AfImyX203uNPxGHYxtNoPwuoBmW0eyV_W9nDNXbdQqs-jw&oe=681D7FBB&_nc_sid=982cc7","width":480}],"video_duration":55.85,"has_audio":true}],"is_nux":false,"title":"GRWM chats","created_at":1743889595,"is_pinned_highlight":false,"prefetch_count":0,"media_count":25,"media_ids":["3565907942018983442"],"is_converted_to_clips":false,"disabled_reply_types":["story_remix_reply"],"highlight_reel_type":"DEFAULT","is_added_to_main_grid":false,"is_archived":false,"is_fit_green":true},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/instagram/profile/post-count":{"post":{"operationId":"social_instagram_profile_post_count","x-nexscope-slug":"social-instagram-profile-post-count","summary":"Instagram Profile Post Count","description":"Returns the post count shown on a public Instagram profile. Use this endpoint when Profile returns media_count as null or edge_owner_to_timeline_media.count contains only the current batch size. This endpoint makes a separate Instagram profile-page request so it does not add latency to the main Profile endpoint. Full values such as 12,345 Posts return the exact integer with is_estimated set to false. For profiles with more than 10,000 posts, Instagram may expose only a compact value such as 12K Posts or 1.2M Posts. Set allow_estimated=true to return the scaled integer with is_estimated set to true. Estimated counts are opt-in: when allow_estimated is omitted or false, the endpoint returns an uncharged 422 response explaining that exact precision is unavailable. If Instagram omits the count entirely, the endpoint returns an error without deducting a credit. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Profile Post Count API View Pricing Get a profile's post count. Estimates require allow_estimated=true; otherwise estimate-only results return an uncharged 422. 1 credit per request\nReturns the post count shown on a public Instagram profile. Use this endpoint when Profile returns media_count as null or edge_owner_to_timeline_media.count contains only the current batch size. This endpoint makes a separate Instagram profile-page request so it does not add latency to the main Profile endpoint. Full values such as 12,345 Posts return the exact integer with is_estimated set to false. For profiles with more than 10,000 posts, Instagram may expose only a compact value such as 12K Posts or 1.2M Posts. Set allow_estimated=true to return the scaled integer with is_estimated set to true. Estimated counts are opt-in: when allow_estimated is omitted or false, the endpoint returns an uncharged 422 response explaining that exact precision is unavailable. If Instagram omits the count entirely, the endpoint returns an error without deducting a credit.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Instagram handle"},"allow_estimated":{"type":"boolean","description":"Set to true to return scaled estimates when Instagram abbreviates counts for profiles with more than 10,000 posts. Defaults to false; false or omitted returns an uncharged 422 when only an estimate is available."}},"required":["handle"],"additionalProperties":false},"example":{"handle":"lifestyleperfume"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","data":{"success":true,"handle":"lifestyleperfume","media_count":2774,"is_estimated":false},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/instagram/user/embed":{"post":{"operationId":"social_instagram_user_embed","x-nexscope-slug":"social-instagram-user-embed","summary":"Instagram Embed HTML","description":"Returns the raw HTML embed snippet for an Instagram user's profile widget. The response contains a single html string that can be inserted into a webpage to render an embeddable Instagram profile card. Requires the user's handle as input. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Instagram Embed HTML API View Pricing Get the HTML embed for an Instagram profile. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Instagram handle"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"jane"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"instagram","data":{"success":true,"html":"<!DOCTYPE html>\n<html lang=\"en\" id=\"facebook\" class=\"no_js\">\n<head><meta charset=\"utf-8....."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/youtube/channel":{"post":{"operationId":"social_youtube_channel","x-nexscope-slug":"social-youtube-channel","summary":"YouTube Channel Details","description":"Retrieves comprehensive YouTube channel profile data including name, avatar images, subscriber count (subscribers), total video and view counts, join date, tags, and linked social accounts like Twitter and Instagram. Accepts a channelId, handle, or full channel URL as input. Returns channel metadata such as country, email, and external store links when available. Contact fields come from the submitted public profile. To request removal of your own information from Scrape Creators results, email support@scrapecreators.com with the profile URL. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Channel Details API View Pricing Get YouTube channel details and stats by channelId, handle, or URL. 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"channelId":{"pattern":"^UC[A-Za-z0-9_-]{22}$","type":"string"},"handle":{"type":"string","maxLength":101,"minLength":1},"url":{"type":"string","maxLength":2048,"minLength":1},"cacheMaxAge":{"enum":["1d","3d","7d","14d","30d"],"type":"string"}},"additionalProperties":false,"type":"object","required":[],"oneOf":[{"not":{"anyOf":[{"required":["handle"]},{"required":["url"]}]},"required":["channelId"]},{"not":{"anyOf":[{"required":["channelId"]},{"required":["url"]}]},"required":["handle"]},{"not":{"anyOf":[{"required":["channelId"]},{"required":["handle"]}]},"required":["url"]}]},"example":{"handle":"@YouTube"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"platform":{"enum":["instagram","youtube","reddit","pinterest"],"type":"string"},"resourceStatus":{"enum":["AVAILABLE","PARTIAL","PRIVATE","RESTRICTED","NOT_FOUND","NO_TRANSCRIPT","UNKNOWN"],"type":"string"},"fetchedAt":{"format":"date-time","type":"string"},"sourceFetchedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"usage":{"properties":{"billingStatus":{"enum":["NOT_CHARGED","SETTLED","UNKNOWN"],"type":"string"},"chargedCredits":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["billingStatus","chargedCredits"]},"channel":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"subscriberCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"videoCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"viewCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","handle","name","description","url","avatarUrl","subscriberCount","videoCount","viewCount"]},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["platform","resourceStatus","fetchedAt","sourceFetchedAt","usage","channel"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","resourceStatus":"NOT_FOUND","fetchedAt":"2026-10-28T00:00:00Z","sourceFetchedAt":null,"usage":{"billingStatus":"UNKNOWN","chargedCredits":null},"channel":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/youtube/channel-videos":{"post":{"operationId":"social_youtube_channel_videos","x-nexscope-slug":"social-youtube-channel-videos","summary":"YouTube Channel Videos","description":"Fetches a paginated list of videos uploaded by a YouTube channel, including each video's title, URL, thumbnail, view count (views), publish date, duration, and description. Supports sorting by latest or popular, and use the continuationToken to page through all results. Optionally include extras like like count, comment count, and descriptions for each video. Paid-promotion filtering is not supported on this endpoint. Use /v1/youtube/video and read isPaidPromotion to check each video's paid-promotion status. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Channel Videos API View Pricing Get paginated videos from a YouTube channel by channelId or handle. Paid-promotion filtering is not supported; use /v1/youtube/video and its isPaidPromotion field for each video's status. 1 credit per request\nFetches a paginated list of videos uploaded by a YouTube channel, including each video's title, URL, thumbnail, view count (views), publish date, duration, and description. Supports sorting by latest or popular, and use the continuationToken to page through all results. Optionally include extras like like count, comment count, and descriptions for each video. Paid-promotion filtering is not supported on this endpoint. Use /v1/youtube/video and read isPaidPromotion to check each video's paid-promotion status.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channelId":{"type":"string","description":"YouTube channel ID"},"handle":{"type":"string","description":"YouTube channel handle"},"sort":{"type":"string","enum":["latest","popular"],"description":"Sort by latest or popular"},"includeExtras":{"type":"string","description":"This will get you the like + comment count and the description. To get the full details of the video, use the /v1/youtube/video endpoint. Honestly, if you use this param, the error rate is higher. We might deprecate this param in the future."},"continuationToken":{"type":"string","description":"Continuation token to get more videos. Get 'continuationToken' from previous response."}},"required":[],"additionalProperties":false},"example":{"handle":"ThePatMcAfeeShow"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","data":{"success":true,"videos":[{"type":"video","id":"5EWaxmWgQMI","url":"https://www.youtube.com/watch?v=5EWaxmWgQMI","title":"Russell Wilson Hopes To Finish Career As A Steeler, Reflects On NFL Career With Pat McAfee","description":"Welcome to The Pat McAfee Show LIVE from Noon-3PM EST Mon-Fri. You can also find us live on ESPN, ESPN+, & TikTok!\n\nBecome a #McAfeeMafia member! https://www.youtube.com/channel/UCxcTeAKWJca6XyJ37_...","thumbnail":"https://i.ytimg.com/vi/5EWaxmWgQMI/hqdefault.jpg?sqp=-oaymwEnCNACELwBSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLBZIBEJGcYDrduIZJpaSmYHcIHJ6g","channel":{"title":"","thumbnail":null},"viewCountText":"110,447 views","viewCountInt":110447,"publishedTimeText":"9 days ago","publishedTime":"2025-01-23T22:48:53.914Z","lengthText":"37:25","lengthSeconds":2245,"badges":[]}],"continuationToken":"4qmFsgLlFhIYV...."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/youtube/channel/search":{"post":{"operationId":"social_youtube_channel_search","x-nexscope-slug":"social-youtube-channel-search","summary":"YouTube Channel Search","description":"Search within one YouTube channel using YouTube's native channel search, not global search or local filtering of the channel's latest videos. Pass a handle with or without @ and a keyword query. Results can include videos, Shorts, live streams and playlists in separate collections. Keep the same handle and query when passing the previous response's continuationToken. Stop when continuationToken is null; passing the literal continuationToken=null returns an uncharged terminal response. Each successful page costs 1 credit, including pages with no matches; invalid requests and retrieval failures are not charged. YouTube can repeat results across pages, so deduplicate by item ID if needed. No sort, date, duration or result-count filters are supported by this endpoint. The response example is shortened from a real search; result order, counts and pagination tokens can change. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Channel Search API View Pricing Search within one YouTube channel by keyword. Returns videos, Shorts, live streams and playlists. Costs 1 credit per page, even with no matches. 1 credit per request\nSearch within one YouTube channel using YouTube's native channel search, not global search or local filtering of the channel's latest videos. Pass a handle with or without @ and a keyword query. Results can include videos, Shorts, live streams and playlists in separate collections. Keep the same handle and query when passing the previous response's continuationToken. Stop when continuationToken is null; passing the literal continuationToken=null returns an uncharged terminal response. Each successful page costs 1 credit, including pages with no matches; invalid requests and retrieval failures are not charged. YouTube can repeat results across pages, so deduplicate by item ID if needed. No sort, date, duration or result-count filters are supported by this endpoint. The response example is shortened from a real search; result order, counts and pagination tokens can change.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"YouTube channel handle, with or without @."},"query":{"type":"string","description":"Keywords to search within this channel."},"continuationToken":{"type":"string","description":"Token from the previous response. Keep the same handle and query; stop when the token is null."}},"required":["handle","query"],"additionalProperties":false},"example":{"handle":"NASA","query":"artemis"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","data":{"success":true,"videos":[{"type":"video","id":"_eeZQw9PBc0","url":"https://www.youtube.com/watch?v=_eeZQw9PBc0","title":"Artemis II Launches Astronauts to the Moon (Official NASA Recap)","thumbnail":"https://i.ytimg.com/vi/_eeZQw9PBc0/hqdefault.jpg?sqp=-oaymwEnCNACELwBSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLC59RvmXk61RYq4qq4Wv2WFDDJQcA","channel":{"id":"UCLA_DiR1FfKNvjuUpBHmylQ","title":"NASA","handle":"NASA","thumbnail":"https://yt3.googleusercontent.com/eIf5fNPcIcj9ig-wZBeq4stFy1lgjWTW1nLT5dYlFkHZprZ03QBiMcbpwNMB6XSBjrSFGtAGQg=s68-c-k-c0x00ffffff-no-rj"},"viewCountText":"1,649,926 views","viewCountInt":1649926,"publishedTimeText":"6mo ago","publishedTime":null,"lengthText":"2:24","lengthSeconds":144,"badges":["CC"]}],"channels":[],"playlists":[{"type":"playlist","id":"PL2aBZuCeDwlQvNtHhNJtarm9OewQwVntv","title":"Artemis II Mission Coverage","thumbnail":"https://i.ytimg.com/vi/DYY4nnfxKbU/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLAi1OCwehE4YN4-jFbe-SlII4gyyw","channel":{"id":"UCLA_DiR1FfKNvjuUpBHmylQ","title":"NASA · Playlist"},"videoCount":"23 videos"}],"shorts":[{"type":"short","id":"vMGuObY8_sw","url":"https://www.youtube.com/watch?v=vMGuObY8_sw","title":"Relive NASA's Artemis II Launch","thumbnail":"https://i.ytimg.com/vi/vMGuObY8_sw/hq2.jpg?sqp=-oaymwFBCNACELwBSFryq4qpAzMIARUAAIhCGADYAQHiAQoIGBACGAY4AUAB8AEB-AG2CIACgA-KAgwIABABGHIgWyg-MA8=&rs=AOn4CLDHJ3063Ni7HpCRBtgzI6qn9OYC6g","channel":{"id":"UCLA_DiR1FfKNvjuUpBHmylQ","title":"NASA","handle":"NASA","thumbnail":"https://yt3.googleusercontent.com/eIf5fNPcIcj9ig-wZBeq4stFy1lgjWTW1nLT5dYlFkHZprZ03QBiMcbpwNMB6XSBjrSFGtAGQg=s68-c-k-c0x00ffffff-no-rj"},"viewCountText":"2,724,313 views","viewCountInt":2724313,"publishedTimeText":"6mo ago","publishedTime":null,"lengthText":"0:33","lengthSeconds":33,"badges":["CC"]}],"shelves":[],"lives":[{"type":"live","id":"nfhDuOHMp0A","url":"https://www.youtube.com/watch?v=nfhDuOHMp0A","title":"NASA’s Artemis II Crew Comes Home (Official Broadcast)","thumbnail":"https://i.ytimg.com/vi/nfhDuOHMp0A/hqdefault.jpg?sqp=-oaymwEnCNACELwBSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLAjOO178lfqwhZPRUo8SdcXZDfO8w","channel":{"id":"UCLA_DiR1FfKNvjuUpBHmylQ","title":"NASA","handle":"NASA","thumbnail":"https://yt3.googleusercontent.com/eIf5fNPcIcj9ig-wZBeq4stFy1lgjWTW1nLT5dYlFkHZprZ03QBiMcbpwNMB6XSBjrSFGtAGQg=s68-c-k-c0x00ffffff-no-rj"},"viewCountText":"27,771,040 views","viewCountInt":27771040,"publishedTimeText":"Streamed 6mo ago","publishedTime":null,"lengthText":"3:53:41","lengthSeconds":14021,"badges":["CC"]}],"continuationToken":"CONTINUATION_TOKEN_FROM_RESPONSE"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/youtube/channel/playlists":{"post":{"operationId":"social_youtube_channel_playlists","x-nexscope-slug":"social-youtube-channel-playlists","summary":"YouTube Channel Playlists","description":"Fetches playlists from a YouTube channel's Playlists tab, including playlist ID, title, thumbnail, video count, channel info, playlist URL, and a continuationToken when YouTube has more results. Pass a handle or channelId for the first page, then pass continuationToken to page through more playlists. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Channel Playlists API View Pricing Get playlists from a YouTube channel. Can pass channelId or handle. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channelId":{"type":"string","description":"YouTube channel ID"},"handle":{"type":"string","description":"YouTube channel handle"},"continuationToken":{"type":"string","description":"Continuation token to get more playlists. Get 'continuationToken' from previous response."}},"required":[],"additionalProperties":false},"example":{"handle":"ThePatMcAfeeShow"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","data":{"success":true,"playlists":[{"type":"playlist","id":"PLYMWLvk9WbU8","title":"The Diary Of A Polarizing Figure","thumbnail":"https://i.ytimg.com/vi/gQ8QVZuDLGQ/hqdefault.jpg","playlistUrl":"https://www.youtube.com/playlist?list=PLYMWLvk9WbU8","videoId":"gQ8QVZuDLGQ","videoUrl":"https://www.youtube.com/watch?v=gQ8QVZuDLGQ","videoCount":14,"channel":{"id":"UCxcTeAKWJca6XyJ37_ZoKIQ","title":"The Pat McAfee Show","handle":"ThePatMcAfeeShow","channelUrl":"https://www.youtube.com/@ThePatMcAfeeShow"}}],"continuationToken":"4qmFsgLlFhIYV...."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/youtube/channel/lives":{"post":{"operationId":"social_youtube_channel_lives","x-nexscope-slug":"social-youtube-channel-lives","summary":"YouTube Channel Lives","description":"Fetches live streams and past streams from a YouTube channel's Live tab, including title, URL, thumbnail, view count, publish time, duration, and a continuationToken when YouTube has more results. Pass a handle or channelId for the first page, then pass continuationToken to page through more lives. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Channel Lives API View Pricing Get live streams and past streams from a YouTube channel. Can pass channelId or handle. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channelId":{"type":"string","description":"YouTube channel ID"},"handle":{"type":"string","description":"YouTube channel handle"},"continuationToken":{"type":"string","description":"Continuation token to get more lives. Get 'continuationToken' from previous response."}},"required":[],"additionalProperties":false},"example":{"handle":"IShowSpeed"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","data":{"success":true,"lives":[{"type":"live","id":"JpVtso3S9rM","url":"https://www.youtube.com/watch?v=JpVtso3S9rM","title":"IShowSpeed Live Stream","thumbnail":"https://i.ytimg.com/vi/JpVtso3S9rM/hqdefault.jpg","channel":{"id":null,"title":null,"handle":null,"thumbnail":null},"viewCountText":"1.2M views","viewCountInt":1200000,"publishedTimeText":"Streamed 2 days ago","lengthText":"2:14:52","lengthSeconds":8092,"badges":[]}],"continuationToken":"4qmFsgLlFhIYV...."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/youtube/channel/community-posts":{"post":{"operationId":"social_youtube_channel_community_posts","x-nexscope-slug":"social-youtube-channel-community-posts","summary":"YouTube Channel Community Posts","description":"Fetches community posts from a YouTube channel's Posts tab, including post ID, URL, content, images, attached video, like count, publish time, channel info, and a continuationToken when YouTube has more results. Pass a handle or channelId for the first page, then pass continuationToken to page through more posts. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Channel Community Posts API View Pricing Get community posts from a YouTube channel. Can pass channelId or handle. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channelId":{"type":"string","description":"YouTube channel ID"},"handle":{"type":"string","description":"YouTube channel handle"},"continuationToken":{"type":"string","description":"Continuation token to get more community posts. Get 'continuationToken' from previous response."}},"required":[],"additionalProperties":false},"example":{"handle":"MrBeast"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","data":{"success":true,"posts":[{"id":"UgkxfMvMnSnV3Ww9HwAY2wFGmVevmhRaYAYO","url":"https://www.youtube.com/post/UgkxfMvMnSnV3Ww9HwAY2wFGmVevmhRaYAYO","channel":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","title":"MrBeast","url":"https://www.youtube.com/@MrBeast","handle":"MrBeast"},"content":"New video is live","image":"https://yt3.ggpht.com/example-image=s640-c-fcrop64","images":["https://yt3.ggpht.com/example-image=s640-c-fcrop64"],"likeCountText":"250K","likeCount":250000,"publishedTimeText":"2 days ago","publishedTime":"2026-05-24T12:00:00.000Z","video":{"id":"tnTPaLOaHz8","title":"If You Survive, You Win","thumbnail":"https://i.ytimg.com/vi/tnTPaLOaHz8/hqdefault.jpg","url":"https://www.youtube.com/watch?v=tnTPaLOaHz8","viewCountText":"10M views","viewCountInt":10000000,"publishedTimeText":"2 days ago","lengthText":"18:42","lengthSeconds":1122}}],"continuationToken":"4qmFsgLlFhIYV...."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/youtube/channel/shorts":{"post":{"operationId":"social_youtube_channel_shorts","x-nexscope-slug":"social-youtube-channel-shorts","summary":"YouTube Channel Shorts","description":"Retrieves a paginated list of short-form videos (Shorts) from a YouTube channel, including each short's title, URL, view count (views), likes, comments, description, and publish date. publishDate is a full ISO 8601 timestamp with an offset when YouTube exposes the exact publish time; otherwise it is null. It does not return date-only strings. Supports sorting by newest or popular; use the continuationToken to page through all results. Returns data in the shorts array. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Channel Shorts API View Pricing Get channel Shorts. publishDate is an ISO 8601 timestamp with an offset when available, otherwise null; date-only values are not returned. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Can pass channelId or handle"},"channelId":{"type":"string","description":"Can pass channelId or handle"},"sort":{"type":"string","enum":["newest","popular"],"description":"Sort by newest or popular"},"continuationToken":{"type":"string","description":"Continuation token to get more videos. Get 'continuationToken' from previous response."}},"required":[],"additionalProperties":false},"example":{}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","data":{"success":true,"videos":[],"channels":[],"playlists":[],"shorts":[{"type":"short","id":"VREVC0wXPfs","url":"https://www.youtube.com/watch?v=VREVC0wXPfs","title":"This idea validation formula has made him $500K from iOS apps","thumbnail":"https://img.youtube.com/vi/VREVC0wXPfs/maxresdefault.jpg","viewCountText":"17,066","viewCountInt":17066,"description":"Most founders think their app isn’t selling because of market conditions.\n\nIt’s not.\n\nThis founder sold multiple apps and noticed the same pattern every time: Great products but broken deals.\n\nNot because the app was bad but because founders overcomplicate operations and chase the highest price instead of the fastest close.","commentCountText":"2","commentCountInt":2,"likeCountInt":495,"likeCountText":"495","publishDate":"2026-04-22T10:44:35-07:00","genre":"People & Blogs","durationMs":37000,"durationFormatted":"00:00:37"}],"shelves":[],"lives":[],"continuationToken":"4qmFsgK7DBIY....."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/youtube/videoDetail":{"post":{"operationId":"social_youtube_video_detail","x-nexscope-slug":"social-youtube-video-detail","summary":"YouTube Video/Short Details","description":"Fetches full details for a YouTube video or short, including title, description, thumbnail, view count (views), like count (likes), comment count, publish date, duration, genre, keywords, chapters, collaborators, and available caption tracks (subtitles/captions). isPaidPromotion is true when YouTube marks the video as including paid promotion and false when it does not. Also returns related recommended videos in watchNextVideos. The legacy channel object is unchanged for compatibility and can mix uploader and artist identities on merged music channels; use uploader for the uploading channel and ownerByline for the channel displayed under the video. ownerByline includes native badge styles and subscriberCountText as YouTube displays it, not an exact subscriber count. descriptionCards contains Music, Games, People mentioned and podcast cards from the structured description. Each card has section, title, subtitle, secondarySubtitle, image, videoId, channelId, playlistId and musicCredits. Missing card fields are null; People mentioned cards can have no linked channel. musicCredits is null when absent, otherwise it includes song, artist, album, writers, licensedToYouTubeBy and the preserved rawText. Owner fields are ownerByline.channelId, name, url, subscriberCountText and badges (style and label). Uploader fields are uploader.channelId, author and url. Either identity can be null when unavailable. An empty array means the description was available with no cards; null means it was unavailable or could not be recognized. isMadeWithAI is true when YouTube exposes the Made with AI disclosure, false when a recognized description has no such disclosure, and null when unknown. This is YouTube disclosure metadata, not our own AI-content detection. Auto-dubbed audio alone does not set isMadeWithAI. aiDisclosure retains the available disclosure text; localized unrecognized disclosures remain unknown. These fields reuse the already-fetched watch page without a separate channel request. When YouTube exposes its public Most replayed graph, most_replayed contains normalized graph buckets in markers and YouTube's highlighted ranges in ranges. The field is null when the graph is not available. YouTube says the graph may be unavailable when the channel has active strikes, the content is potentially inappropriate, the video is too new or has too few views, or its systems deem the video ineligible for another reason. YouTube does not publish fixed age or view-count thresholds. Age-restricted videos return 403 with message: \"This video is age restricted\" because Scrape Creators only uses the public logged-out YouTube source. Need to download a YouTube video? We open sourced our [YouTube downloader](https://github.com/ScrapeCreators/youtube-downloader). You can use it and host it wherever you want. We don't offer a hosted YouTube downloading service because it's expensive and compute-intensive to run. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Video/Short Details API View Pricing Get YouTube video or Short details, description cards, AI disclosures, owner/uploader identities, paid-promotion status and replay heatmaps. Age-restricted videos return 403. No hosted video downloads. 1 credit per request\nFetches full details for a YouTube video or short, including title, description, thumbnail, view count (views), like count (likes), comment count, publish date, duration, genre, keywords, chapters, collaborators, and available caption tracks (subtitles/captions). isPaidPromotion is true when YouTube marks the video as including paid promotion and false when it does not. Also returns related recommended videos in watchNextVideos. The legacy channel object is unchanged for compatibility and can mix uploader and artist identities on merged music channels; use uploader for the uploading channel and ownerByline for the channel displayed under the video. ownerByline includes native badge styles and subscriberCountText as YouTube displays it, not an exact subscriber count. descriptionCards contains Music, Games, People mentioned and podcast cards from the structured description. Each card has section, title, subtitle, secondarySubtitle, image, videoId, channelId, playlistId and musicCredits. Missing card fields are null; People mentioned cards can have no linked channel. musicCredits is null when absent, otherwise it includes song, artist, album, writers, licensedToYouTubeBy and the preserved rawText. Owner fields are ownerByline.channelId, name, url, subscriberCountText and badges (style and label). Uploader fields are uploader.channelId, author and url. Either identity can be null when unavailable. An empty array means the description was available with no cards; null means it was unavailable or could not be recognized. isMadeWithAI is true when YouTube exposes the Made with AI disclosure, false when a recognized description has no such disclosure, and null when unknown. This is YouTube disclosure metadata, not our own AI-content detection. Auto-dubbed audio alone does not set isMadeWithAI. aiDisclosure retains the available disclosure text; localized unrecognized disclosures remain unknown. These fields reuse the already-fetched watch page without a separate channel request. When YouTube exposes its public Most replayed graph, most_replayed contains normalized graph buckets in markers and YouTube's highlighted ranges in ranges. The field is null when the graph is not available. YouTube says the graph may be unavailable when the channel has active strikes, the content is potentially inappropriate, the video is too new or has too few views, or its systems deem the video ineligible for another reason. YouTube does not publish fixed age or view-count thresholds. Age-restricted videos return 403 with message: \"This video is age restricted\" because Scrape Creators only uses the public logged-out YouTube source. Need to download a YouTube video? We open sourced our [YouTube downloader](https://github.com/ScrapeCreators/youtube-downloader). You can use it and host it wherever you want. We don't offer a hosted YouTube downloading service because it's expensive and compute-intensive to run.\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"url":{"type":"string","maxLength":2048,"minLength":1},"language":{"pattern":"^[a-z]{2}$","type":"string"},"cacheMaxAge":{"enum":["1d","3d","7d","14d","30d"],"type":"string"}},"additionalProperties":false,"type":"object","required":["url"]},"example":{"url":"https://www.youtube.com/watch?v=bjVIDXPP7Uk"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"platform":{"enum":["instagram","youtube","reddit","pinterest"],"type":"string"},"resourceStatus":{"enum":["AVAILABLE","PARTIAL","PRIVATE","RESTRICTED","NOT_FOUND","NO_TRANSCRIPT","UNKNOWN"],"type":"string"},"fetchedAt":{"format":"date-time","type":"string"},"sourceFetchedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"usage":{"properties":{"billingStatus":{"enum":["NOT_CHARGED","SETTLED","UNKNOWN"],"type":"string"},"chargedCredits":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["billingStatus","chargedCredits"]},"item":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"thumbnailUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"viewCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"likeCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"commentCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"durationSeconds":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"type":{"enum":["VIDEO","SHORT","UNKNOWN"],"type":"string"},"channel":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","handle","name","url"]},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","url","title","description","thumbnailUrl","publishedAt","viewCount","likeCount","commentCount","durationSeconds","type","channel"]},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["platform","resourceStatus","fetchedAt","sourceFetchedAt","usage","item"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","resourceStatus":"NOT_FOUND","fetchedAt":"2026-10-28T00:00:00Z","sourceFetchedAt":null,"usage":{"billingStatus":"UNKNOWN","chargedCredits":null},"item":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/youtube/transcript":{"post":{"operationId":"social_youtube_transcript","x-nexscope-slug":"social-youtube-transcript","summary":"YouTube Transcript","description":"Retrieves publicly available captions, subtitles, or transcripts from a YouTube video or Short. Returns both a timestamped transcript array with start/end times and a plain-text version in transcript_only_text. Supports specifying a language code. Videos of any length are supported when YouTube exposes public captions. This endpoint does not use AI transcription. A returned transcript costs 1 credit; missing captions cost 0 credits. If no matching caption track is available, the transcript fields return null. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Transcript API View Pricing Get publicly available captions or a transcript from a YouTube video or Short 1 credit per request\nRetrieves publicly available captions, subtitles, or transcripts from a YouTube video or Short. Returns both a timestamped transcript array with start/end times and a plain-text version in transcript_only_text. Supports specifying a language code. Videos of any length are supported when YouTube exposes public captions. This endpoint does not use AI transcription. A returned transcript costs 1 credit; missing captions cost 0 credits. If no matching caption track is available, the transcript fields return null.\nLanguage code, ie 'en', 'es', 'fr' or 'en-US'. Overrides the default track selection unless original_audio=true. If omitted, prefers captions matching the original spoken language when YouTube identifies the original audio. If that metadata is unavailable or ambiguous, prefers an auto-generated caption, otherwise the first caption track. If the requested or identified original language has no matching captions, the transcript will be null and no credits are charged.\nSet to true to return captions only in the original spoken language identified by YouTube. Takes precedence over language. If the original audio cannot be reliably identified or has no matching captions, transcript, transcript_only_text, and language are null and no credits are charged. No extra lookup or credit cost; a returned transcript costs the usual 1 credit. Omit or set to false for the existing default selection.\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"url":{"type":"string","maxLength":2048,"minLength":1},"language":{"type":"string","pattern":"^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$","maxLength":35},"originalAudio":{"default":false,"type":"boolean"},"cacheMaxAge":{"enum":["1d","3d","7d","14d","30d"],"type":"string"}},"additionalProperties":false,"type":"object","required":["url"]},"example":{"url":"https://www.youtube.com/watch?v=bjVIDXPP7Uk"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"platform":{"enum":["instagram","youtube","reddit","pinterest"],"type":"string"},"resourceStatus":{"enum":["AVAILABLE","PARTIAL","PRIVATE","RESTRICTED","NOT_FOUND","NO_TRANSCRIPT","UNKNOWN"],"type":"string"},"fetchedAt":{"format":"date-time","type":"string"},"sourceFetchedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"usage":{"properties":{"billingStatus":{"enum":["NOT_CHARGED","SETTLED","UNKNOWN"],"type":"string"},"chargedCredits":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["billingStatus","chargedCredits"]},"transcript":{"anyOf":[{"properties":{"kind":{"enum":["MANUAL","AUTOMATIC","UNKNOWN"],"type":"string"},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"segments":{"items":{"properties":{"text":{"type":"string"},"startMs":{"minimum":0,"type":"number"},"endMs":{"minimum":0,"type":"number"}},"additionalProperties":false,"type":"object","required":["text","startMs","endMs"]},"type":"array"}},"additionalProperties":false,"type":"object","required":["kind","language","segments"]},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["platform","resourceStatus","fetchedAt","sourceFetchedAt","usage","transcript"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","resourceStatus":"NO_TRANSCRIPT","fetchedAt":"2026-10-28T00:00:00Z","sourceFetchedAt":null,"usage":{"billingStatus":"UNKNOWN","chargedCredits":null},"transcript":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/youtube/video/sponsors":{"post":{"operationId":"social_youtube_video_sponsors","x-nexscope-slug":"social-youtube-video-sponsors","summary":"YouTube Video Sponsors","description":"Experimental endpoint. Checks a YouTube video for the paid-promotion disclosure and infers likely sponsors/promoted brands from the public description, description links, promo-code text, and transcript. YouTube tells us that a video contains paid promotion, but it does not always tell us the sponsor directly, so this endpoint returns suspected sponsors with confidence and evidence. This is inferred, not an official YouTube sponsor field. Feedback welcome: support@scrapecreators.com Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Video Sponsors API View Pricing Experimental: infer possible video sponsors from public evidence, not an official YouTube sponsor field. Send feedback to support@scrapecreators.com. 1 credit per request\nExperimental endpoint. Checks a YouTube video for the paid-promotion disclosure and infers likely sponsors/promoted brands from the public description, description links, promo-code text, and transcript. YouTube tells us that a video contains paid promotion, but it does not always tell us the sponsor directly, so this endpoint returns suspected sponsors with confidence and evidence. This is inferred, not an official YouTube sponsor field. Feedback welcome: support@scrapecreators.com","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"YouTube video or short URL"},"language":{"type":"string","description":"2 letter language code used for transcript lookup, ie 'en', 'es', 'fr' etc."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.youtube.com/watch?v=AVO0ifle-OU"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","data":{"success":true,"video":{"id":"AVO0ifle-OU","url":"https://www.youtube.com/watch?v=AVO0ifle-OU","title":"Why You Should Meal Prep Like A Restaurant","channel":{"id":"UC3vQEjRhwgH2HAOBKwLjxNA","url":"https://www.youtube.com/@letsKWOOWK","handle":"letsKWOOWK","title":"KWOOWK"},"isPaidPromotion":true},"suspectedSponsors":[{"name":"Betterhelp","website":"betterhelp.com","confidence":"medium","evidence":[{"source":"description_link","text":"If you're struggling, consider therapy with our sponsor BetterHelp. Click https://betterhelp.com/KWOOWK for a 10% discount..."}]}],"sponsorDetection":{"status":"found","methods":["paid promotion badge"],"transcriptAvailable":true,"note":"Sponsors are inferred from public description, links, promo-code text, and transcript evidence."}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/youtube/search":{"post":{"operationId":"social_youtube_search","x-nexscope-slug":"social-youtube-search","summary":"YouTube Search","description":"Searches YouTube by keyword query and returns matching videos, channels, playlists, shorts, shelves, and live streams. Each video result includes title, URL, thumbnail, view count (views), publish date, duration, channel info, and badges. Supports filtering by upload date, sorting by relevance or popularity, and paginating with continuationToken. Set is_paid_promotions=true to search YouTube videos with the paid product placement / sponsorship disclosure. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Search API View Pricing Search YouTube videos, channels, playlists, Shorts and live streams. Response format video . 1 credit per request\nSearches YouTube by keyword query and returns matching videos, channels, playlists, shorts, shelves, and live streams. Each video result includes title, URL, thumbnail, view count (views), publish date, duration, channel info, and badges. Supports filtering by upload date, sorting by relevance or popularity, and paginating with continuationToken. Set is_paid_promotions=true to search YouTube videos with the paid product placement / sponsorship disclosure.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keyword":{"type":"string","maxLength":1000,"minLength":1},"uploadDate":{"enum":["today","this_week","this_month","this_year"],"type":"string"},"sortBy":{"enum":["relevance","popular"],"type":"string","default":"relevance"},"type":{"enum":["videos","shorts","channels","playlists"],"type":"string"},"duration":{"type":"string","enum":["under_3_min","between_3_and_20_min","over_20_min"],"description":"Duration of the video. Only applies to videos (not shorts)."},"region":{"type":"string","description":"2 letter country code of the country to put the proxy in."},"includeExtras":{"type":"string","description":"This will get you the like + comment count and the description. To get the full details of the video, use the /v1/youtube/video endpoint. *This will slow down the response slightly.*"},"cursor":{"description":"Opaque single-page cursor, at most 65536 UTF-8 bytes.","type":"string","minLength":1}},"additionalProperties":false,"type":"object","required":["keyword"]},"example":{"keyword":"coffee"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"platform":{"enum":["instagram","youtube","reddit","pinterest"],"type":"string"},"resourceStatus":{"enum":["AVAILABLE","PARTIAL","PRIVATE","RESTRICTED","NOT_FOUND","NO_TRANSCRIPT","UNKNOWN"],"type":"string"},"fetchedAt":{"format":"date-time","type":"string"},"sourceFetchedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"usage":{"properties":{"billingStatus":{"enum":["NOT_CHARGED","SETTLED","UNKNOWN"],"type":"string"},"chargedCredits":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["billingStatus","chargedCredits"]},"items":{"items":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"thumbnailUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"viewCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"type":{"enum":["VIDEO","SHORT","CHANNEL","PLAYLIST","LIVE","UNKNOWN"],"type":"string"},"channel":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","handle","name","url"]},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","url","title","description","thumbnailUrl","publishedAt","viewCount","type","channel"]},"type":"array"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"additionalProperties":false,"type":"object","required":["platform","resourceStatus","fetchedAt","sourceFetchedAt","usage","items","nextCursor","hasMore"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","resourceStatus":"NOT_FOUND","fetchedAt":"2026-10-28T00:00:00Z","sourceFetchedAt":null,"usage":{"billingStatus":"UNKNOWN","chargedCredits":null},"items":[],"nextCursor":null,"hasMore":false},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/youtube/search/typeahead":{"post":{"operationId":"social_youtube_search_typeahead","x-nexscope-slug":"social-youtube-search-typeahead","summary":"YouTube Search Typeahead","description":"Returns the live search suggestions YouTube displays while a user types. Each result includes the suggested text and whether it is a normal query or a channel. When YouTube returns a channel suggestion, the response also includes its public channel ID, handle, name, and thumbnail. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Search Typeahead API View Pricing Get the live autocomplete suggestions shown in YouTube's search dropdown. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Partial or complete YouTube search query"}},"required":["query"],"additionalProperties":false},"example":{"query":"mr beast"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","data":{"success":true,"data":{"query":"mr beast","suggestions":[{"text":"mrbeast","type":"channel","channel":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","handle":"@MrBeast","name":"MrBeast","thumbnailUrl":"https://yt3.googleusercontent.com/example=s88-c-k-c0x00ffffff-no-rj"}}]}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/youtube/search/hashtag":{"post":{"operationId":"social_youtube_search_hashtag","x-nexscope-slug":"social-youtube-search-hashtag","summary":"YouTube Search by Hashtag","description":"Searches YouTube for content matching a specific hashtag and returns matching videos with title, URL, thumbnail, view count (views), publish date, duration, and channel info. Supports pagination via continuationToken and filtering to return all content types or only shorts. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Search by Hashtag API View Pricing Search YouTube and get matching videos, channels, and playlists 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hashtag":{"type":"string","description":"Hashtag to search for"},"type":{"type":"string","enum":["all","shorts"],"default":"all","description":"Search for all types of content or only shorts"},"continuationToken":{"type":"string","description":"Continuation token to get more videos. Get 'continuationToken' from previous response."}},"required":["hashtag"],"additionalProperties":false},"example":{"hashtag":"funny"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","data":{"success":true,"videos":[{"type":"video","id":"jXMISgQq9MM","url":"https://www.youtube.com/watch?v=jXMISgQq9MM","title":"Epic fails \uD83E\uDD23\uD83E\uDD23\uD83E\uDD23 #shorts #funny #fails","description":"","thumbnail":"https://i.ytimg.com/vi/jXMISgQq9MM/hqdefault.jpg?sqp=-oaymwFBCNACELwBSFryq4qpAzMIARUAAIhCGADYAQHiAQoIGBACGAY4AUAB8AEB-AG2CIACgA-KAgwIABABGGUgXyhVMA8=&rs=AOn4CLC1HXfxzLayoVBdicS5DIUQh9zGcQ","channel":{"id":"UCvUzWu1Whyw1FWuLl9GOo_g","title":"ZZang Funny","thumbnail":"https://yt3.ggpht.com/rcZKcfewHTzkauGknat3NeC53rGBofYDbL8AjFkwvsk2fXzM1clht7OTn9-1IIPnmbeZkrNGdxI=s68-c-k-c0x00ffffff-no-rj"},"viewCountText":"22,668,056 views","viewCountInt":22668056,"publishedTimeText":"4 weeks ago","publishedTime":"2025-01-04T23:12:42.919Z","lengthText":"1:00","lengthSeconds":60,"badges":[]}],"continuationToken":"4qmFsgLtBRIJRkVoYX...."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/youtube/video/comments":{"post":{"operationId":"social_youtube_video_comments","x-nexscope-slug":"social-youtube-video-comments","summary":"YouTube Comments","description":"Fetches comments and replies from a YouTube video, including each comment's text content, author details, like count, reply count, and publish date. `publishedTime` is a best-effort ISO timestamp calculated from YouTube's relative label, not an exact source timestamp. Supports ordering by top or newest, and paginating with continuationToken. Limited to approximately 1,000 top comments or 7,000 newest comments. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Comments API View Pricing Get comments from a video. Can only get 1k top comments and about 7k new comments. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"YouTube video URL"},"order":{"type":"string","enum":["top","newest"],"description":"Order of comments"},"continuationToken":{"type":"string","description":"Continuation token to get more comments. Get 'continuationToken' from previous response."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","data":{"success":true,"comments":[{"id":"UgwVfRopfS2F-WB3aF14AaABAg","content":"I love how in the middle he said \"I've been able to work with 2 great coaches... Pete and Coach Tomlin\"... Side shade to Coach Sean Payton, love it :)","publishedTimeText":"9 days ago","publishedTime":"2025-01-23T23:14:02.948Z","replyLevel":0,"author":{"name":"@SimonT80","channelId":"UC8JC3uSUmmXTCTKl-bgr1DA","isVerified":false,"isCreator":false,"avatarUrl":"https://yt3.ggpht.com/ytc/AIdro_lQ_2v9lDqwRrmdvEBfDNyFOvgQICl68X6WFkwZ5KI=s88-c-k-c0x00ffffff-no-rj","channelUrl":"https://youtube.com/@SimonT80"},"engagement":{"likes":110,"replies":5},"repliesContinuationToken":"Eg0SC2RRdzR3OVdnWGNRGAYy1AEK..."}],"continuationToken":"Eg0SCzVFV2F4bVd...."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/youtube/video/comment/replies":{"post":{"operationId":"social_youtube_video_comment_replies","x-nexscope-slug":"social-youtube-video-comment-replies","summary":"YouTube Comment Replies","description":"Fetches replies to a specific comment on a YouTube video, including each reply's text content, author details (name, channel ID, avatar, verified/creator status), like count, and publish date. Requires a continuationToken obtained from the 'repliesContinuationToken' field on comments returned by the Comments endpoint. Supports paginating through additional replies with the continuationToken returned in each response. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Comment Replies API View Pricing Get replies to a specific comment on a YouTube video. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"continuationToken":{"type":"string","description":"Continuation token for the comment replies. Use 'repliesContinuationToken' from the Comments endpoint, or 'continuationToken' from a previous replies response to paginate."}},"required":["continuationToken"],"additionalProperties":false},"example":{"continuationToken":"Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIa..."}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","data":{"success":true,"comments":[{"id":"UgyfayX-QqgkPGkcKbt4AaABAg.AV5O1akOhw9AV5RdnpN-SY","content":"Me","publishedTimeText":"20 hours ago","publishedTime":"2026-04-03T05:52:36.883Z","replyLevel":1,"author":{"name":"@pepisakkout2522","channelId":"UCjEBcO_VQ32GUzUZGwlxy1w","isVerified":false,"isCreator":false,"avatarUrl":"https://yt3.ggpht.com/ytc/AIdro_lYQDmh7-5JOb_QcEsPJIp4vmKm5a0uyzAXT-JC0rY=s88-c-k-c0x00ffffff-no-rj","channelUrl":"https://youtube.com/@pepisakkout2522"},"engagement":{"likes":2,"replies":0}}],"continuationToken":"Eg0SC2RRdzR3OVdnWGNRGAYy1AEK..."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/youtube/shorts/trending":{"post":{"operationId":"social_youtube_shorts_trending","x-nexscope-slug":"social-youtube-shorts-trending","summary":"YouTube Trending Shorts","description":"Fetches approximately 48 currently trending YouTube Shorts (viral/popular short-form videos) per call, returning each short's title, URL, thumbnail, view count (views), like count (likes), comment count, publish date, channel info, keywords, and duration. Each subsequent call returns a fresh batch of different trending shorts. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Trending Shorts API View Pricing Get about 48 trending Shorts per request. Repeated requests can return new Shorts. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"example":{}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","data":{"success":true,"shorts":[{"id":"ou0nl5ET0HA","thumbnail":"https://img.youtube.com/vi/ou0nl5ET0HA/maxresdefault.jpg","url":"https://www.youtube.com/watch?v=ou0nl5ET0HA","title":"That hooper who says their just shoes","description":null,"commentCountText":"168","commentCountInt":168,"likeCountText":"151957","likeCountInt":151957,"viewCountText":"13,798,774","viewCountInt":13798774,"publishDateText":"Aug 7, 2025","publishDate":"2025-08-07T13:00:22-07:00","channel":{"id":"UC3iObCgKLKr9xquQw7fCang","url":"https://www.youtube.com/@dameuniverse","handle":"dameuniverse","title":"Dame Universe"},"chapters":[],"keywords":["Kobe"],"durationMs":19000,"durationFormatted":"00:00:19"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/youtube/playlist":{"post":{"operationId":"social_youtube_playlist","x-nexscope-slug":"social-youtube-playlist","summary":"YouTube Playlist","description":"Retrieves a page of videos in a YouTube playlist, including each video's title, URL, thumbnail, duration, and channel. Accepts the playlist ID found in the 'list' URL parameter. The first page includes title, owner, and totalVideos. Later pages return videos and continuationToken without playlist metadata. Pass the previous response's continuationToken to get the next page. Stop when continuationToken is null. Each page costs 1 credit. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Playlist API View Pricing Get a paginated list of videos in a YouTube playlist 1 credit per request\nRetrieves a page of videos in a YouTube playlist, including each video's title, URL, thumbnail, duration, and channel. Accepts the playlist ID found in the 'list' URL parameter. The first page includes title, owner, and totalVideos. Later pages return videos and continuationToken without playlist metadata. Pass the previous response's continuationToken to get the next page. Stop when continuationToken is null. Each page costs 1 credit.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"playlist_id":{"type":"string","description":"The ID of the YouTube playlist. In the YouTube URL it will be the 'list' parameter."},"continuationToken":{"type":"string","description":"Token from the previous response to get the next page. Omit for the first page. Stop when the returned continuationToken is null."}},"required":["playlist_id"],"additionalProperties":false},"example":{"playlist_id":"PLP32wGpgzmIlInfgKVFfCwVsxgGqZNIiS"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","data":{"success":true,"title":"Songs with Lyrics 2025 - New Songs 2025 - Music 2025 New Songs","owner":{"id":"UC0-wiBH12UgtWqLjo-EvpOw","name":"Lovely Tunes","url":"https://www.youtube.com/@lovelytunes7622","handle":"lovelytunes7622"},"totalVideos":98,"videos":[{"id":"AdBzzpq3xV4","title":"Lady Gaga, Bruno Mars - Die With A Smile","thumbnail":"https://i.ytimg.com/vi/AdBzzpq3xV4/hqdefault.jpg?sqp=-oaymwEnCNACELwBSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLABnTkQJmfW0s1BMl_qa0FGqIGGqw","url":"https://www.youtube.com/watch?v=AdBzzpq3xV4","lengthText":"4:15","lengthSeconds":255,"channel":{"title":"LatinHype","url":"https://www.youtube.com/@LatinHype."}}],"continuationToken":null},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/youtube/community-post":{"post":{"operationId":"social_youtube_community_post","x-nexscope-slug":"social-youtube-community-post","summary":"YouTube Community Post Details","description":"Retrieves the full details of a YouTube community post, including its text content, attached images, like count, publish date, and associated channel info. Also returns a linked video if the post includes one. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. YouTube Community Post Details API View Pricing Get the details of a community post 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the YouTube community post to get"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"youtube","data":{"success":true,"id":"Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8","channel":{"id":"UChhw6DlKKTQ9mYSpTfXUYqA","title":"Starter Story","url":"https://www.youtube.com/@starterstory","handle":"starterstory"},"content":"How to build something meaningful\n\n1. sit down\n2. set a timer for 2 hours\n3. work\n4. do that over and over and over\n\nNOTHING meaningful was built in a day, a week, or even a month\n\nyou should launch quickly, but the work can't end there\n\nsuccessful products have YEARS of craft behind them\n\nstart building yours today: http://starterstory.com/bsm","images":["https://yt3.ggpht.com/uer4ij-RqnTqudtdT5VZNvEjzVXA3PGLHwNpjMfraB7mfbX_Bm0-fSpaFXkfw3EA4uZ7BY8YPa1gU08=s640-c-fcrop64=1,20000000dfffffff-rw-nd-v1"],"likeCount":759,"publishedTimeText":"5 days ago","publishedTime":"2025-11-07T18:49:57.492Z","video":null},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/rumble/search":{"post":{"operationId":"social_rumble_search","x-nexscope-slug":"social-rumble-search","summary":"Rumble Search","description":"Searches Rumble videos by keyword. Returns matching videos and shorts with title, URL, thumbnail, channel, published date, viewCountText, viewCountInt, and a numeric cursor for the next page. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Rumble Search API View Pricing Searches Rumble videos by keyword. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query."},"cursor":{"type":"string","description":"Cursor from the previous response. This is the next page number, like 2 or 3."}},"required":["query"],"additionalProperties":false},"example":{"query":"funny cats"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"rumble","data":{"success":true,"query":"funny cats","videos":[{"id":"v6w80h0","url":"https://rumble.com/v6w80h0-democrats-pretend-to-care-about-epstein-nightly-scroll-w-hayley-caronia-ep..html","title":"Democrats Pretend To Care About Epstein - Nightly Scroll w/ Hayley Caronia (Ep.90) - 07/15/2025","thumbnail":"https://hugh.cdn.rumble.cloud/video/fww1/e9/s8/1/K/X/A/2/KXA2y.oq1b.2-small-Democrats-Pretend-To-Care-A.jpg","duration":"10 months ago Democrats Pretend To Care About Epstein - Nightly Scroll w/ Hayley Caronia (Ep.90) - 07/15/2025 BonginoReport Verified","publishedAt":"2025-07-15T16:29:49-04:00","publishedText":"10 months ago","viewCountText":"185,000 views","viewCountInt":185000,"channel":{"name":"BonginoReport Verified","url":"https://rumble.com/user/BonginoReport","handle":"BonginoReport"},"type":"video"}],"channels":[],"playlists":[],"shorts":[{"id":"v79mu94","url":"https://rumble.com/shorts/v79mu94","title":"FUNNY\uD83E\uDD23 CATS","thumbnail":"https://hugh.cdn.rumble.cloud/video/fww1/86/s8/6/O/E/w/m/OEwmA.oq1b.jpg","duration":null,"publishedAt":"2026-05-09T19:22:41-04:00","publishedText":"9 days ago","viewCountText":"327 views","viewCountInt":327,"channel":{"name":"SusieQ4u","url":"https://rumble.com/user/SusieQ4u","handle":"SusieQ4u"},"type":"short"}],"lives":[],"cursor":2},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/rumble/channel/videos":{"post":{"operationId":"social_rumble_channel_videos","x-nexscope-slug":"social-rumble-channel-videos","summary":"Rumble Channel Videos","description":"Gets videos from a Rumble channel by handle or URL. Returns channel metadata, videos, shorts, and a numeric cursor for the next page. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Rumble Channel Videos API View Pricing Gets videos from a Rumble channel by handle or URL. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Rumble channel handle. If you'd prefer to use the URL instead, use the url parameter."},"url":{"type":"string","description":"Rumble channel URL. If you'd prefer to use the handle instead, use the handle parameter."},"cursor":{"type":"string","description":"Cursor from the previous response. This is the next page number, like 2 or 3."}},"required":[],"additionalProperties":false},"example":{"handle":"CuteCats223"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"rumble","data":{"success":true,"channel":{"name":"Cute Cats","url":"https://rumble.com/c/CuteCats223","handle":"CuteCats223"},"videos":[{"id":"v6uyinv","url":"https://rumble.com/v6uyinv-try-not-to-laughfunniest-dogs-and-cats-clips-2025.html","title":"Try Not To LaughFunniest Dogs and Cats Clips 2025","thumbnail":"https://hugh.cdn.rumble.cloud/video/fww1/7e/s8/1/7/J/u/U/7JuUy.oq1b.2-small-Try-Not-To-LaughFunniest-Do.jpg","duration":"20:55","publishedAt":"2025-06-18T05:04:11-04:00","publishedText":"10 months ago","viewCountText":"1,150 views","viewCountInt":1150,"type":"video"}],"shorts":[],"cursor":2},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/rumble/video":{"post":{"operationId":"social_rumble_video","x-nexscope-slug":"social-rumble-video","summary":"Rumble Video","description":"Gets Rumble video details by URL. Returns title, description, thumbnail, channel, publish date, view count, likes, dislikes, captions, and media metadata when available. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Rumble Video API View Pricing Gets Rumble video details by URL. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Rumble video URL."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://rumble.com/v79xhhm-discovery-why-glenn-wants-israel-to-sue-the-new-york-times.html"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"rumble","data":{"success":true,"id":"v79xhhm","numericId":436271810,"embedId":"v77qthe","url":"https://rumble.com/v79xhhm-discovery-why-glenn-wants-israel-to-sue-the-new-york-times.html","embedUrl":"https://rumble.com/embed/v77qthe/","title":"DISCOVERY: Why Glenn WANTS Israel to Sue The New York Times","description":"Follow Glenn Greenwald's writing and other journalism at Substack, where you can become a member: https://greenwald.substack.com/ All videos now available as a podcast! Find full episodes here: https:","thumbnail":"https://hugh.cdn.rumble.cloud/video/fwe2/2f/s8/1/k/V/p/o/kVpoA.qR4e-small-DISCOVERY-Why-Glenn-WANTS-I..jpg","duration":1678,"publishedAt":"2026-05-16T11:31:27+00:00","viewCountText":"17,279 views","viewCountInt":17279,"likeCount":145,"dislikeCount":3,"width":1920,"height":1080,"channel":{"name":"Glenn Greenwald","url":"https://rumble.com/c/GGreenwald","handle":"GGreenwald"},"captions":{"en-auto":{"language":"English (auto)","path":"https://hugh.cdn.rumble.cloud/video/fwe2/2f/s8/11/k/V/p/o/kVpoA.fn8Si.vtt"}},"media":{"tar":{"240":{"url":"https://hugh.cdn.rumble.cloud/video/fwe2/2f/s8/2/k/V/p/o/kVpoA.oaa.tar?r_file=chunklist.m3u8&r_type=application%2Fvnd.apple.mpegurl&r_range=46677504-46694057","meta":{"bitrate":222,"size":46704640,"w":640,"h":360}},"360":{"url":"https://hugh.cdn.rumble.cloud/video/fwe2/2f/s8/2/k/V/p/o/kVpoA.baa.tar?r_file=chunklist.m3u8&r_type=application%2Fvnd.apple.mpegurl&r_range=142485504-142502129","meta":{"bitrate":679,"size":142510080,"w":640,"h":360}},"480":{"url":"https://hugh.cdn.rumble.cloud/video/fwe2/2f/s8/2/k/V/p/o/kVpoA.caa.tar?r_file=chunklist.m3u8&r_type=application%2Fvnd.apple.mpegurl&r_range=222280704-222297420","meta":{"bitrate":1059,"size":222300160,"w":854,"h":480}},"720":{"url":"https://hugh.cdn.rumble.cloud/video/fwe2/2f/s8/2/k/V/p/o/kVpoA.gaa.tar?r_file=chunklist.m3u8&r_type=application%2Fvnd.apple.mpegurl&r_range=449539072-449555872","meta":{"bitrate":2142,"size":449566720,"w":1280,"h":720}}},"timeline":{"180":{"url":"https://hugh.cdn.rumble.cloud/video/fwe2/2f/s8/2/k/V/p/o/kVpoA.Faa.mp4","meta":{"bitrate":11,"size":2508015,"w":320,"h":180}}},"audio":{"192":{"url":"https://hugh.cdn.rumble.cloud/video/fwe2/2f/s8/2/k/V/p/o/kVpoA.Gaa.aac","meta":{"bitrate":195,"size":40281235,"w":0,"h":0}}},"hls":{"auto":{"url":"https://rumble.com/hls-vod/77qthe/playlist.m3u8"}}},"shareUrl":"https://rumble.com/share/v79xhhm?src=VoG0dqZG5JZ6uoPQ0mmpV91Vkao2i8JCNcVBpMIgYffXfccYYhMCQA","isLive":false},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/rumble/video/transcript":{"post":{"operationId":"social_rumble_video_transcript","x-nexscope-slug":"social-rumble-video-transcript","summary":"Rumble Transcript","description":"Gets a Rumble video's transcript when captions are available. If Rumble does not expose captions for the video, transcript will be null and you will not be charged. Returned native captions cost 1 credit; empty transcripts and errors cost 0 credits. This endpoint does not use AI transcription. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Rumble Transcript API View Pricing Gets a Rumble video's transcript when captions are available. 1 credit per request\nGets a Rumble video's transcript when captions are available. If Rumble does not expose captions for the video, transcript will be null and you will not be charged. Returned native captions cost 1 credit; empty transcripts and errors cost 0 credits. This endpoint does not use AI transcription.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Rumble video URL."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://rumble.com/valm19-funny-cat-funny-cat.html"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"rumble","data":{"success":true,"id":"v79xhhm","url":"https://rumble.com/v79xhhm-discovery-why-glenn-wants-israel-to-sue-the-new-york-times.html","language":"English (auto)","transcript":"WEBVTT\r\n\r\n00:00:06.890 --> 00:00:11.050\r\nLet's get into these questions, and we'll try and get through as many as we can.\r\n\r\n00:00:11.190 --> 00:00:15.650\r\nThe first one is from Christi Marbet, who says there were a few questions about this.\r\n\r\n00:00:15.930 --> 00:00:17.730\r\nThey want you to comment on the following"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/rumble/video/comments":{"post":{"operationId":"social_rumble_video_comments","x-nexscope-slug":"social-rumble-video-comments","summary":"Rumble Comments","description":"Gets all top level comments for a Rumble video by URL. Returns comment text, author, createdAt, createdAtText, likeCount, dislikeCount, and replyCount when comment bodies are public. If Rumble requires sign-in to view the comments, this endpoint returns HTTP 403 with error `forbidden` and does not charge credits. This is different from a public video with no comments, which returns a successful empty comments array.\n\nSign-in-required response example:\n```json\n{\n  \"success\": false,\n  \"credits_remaining\": 100,\n  \"credits_charged\": 0,\n  \"error\": \"forbidden\",\n  \"errorStatus\": 403,\n  \"message\": \"Rumble requires you to sign in to view this video's comments\"\n}\n``` Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Rumble Comments API View Pricing Gets all top level comments for a Rumble video by URL. 1 credit per request\nGets all top level comments for a Rumble video by URL. Returns comment text, author, createdAt, createdAtText, likeCount, dislikeCount, and replyCount when comment bodies are public. If Rumble requires sign-in to view the comments, this endpoint returns HTTP 403 with error `forbidden` and does not charge credits. This is different from a public video with no comments, which returns a successful empty comments array.\n\nSign-in-required response example:\n```json\n{\n  \"success\": false,\n  \"credits_remaining\": 100,\n  \"credits_charged\": 0,\n  \"error\": \"forbidden\",\n  \"errorStatus\": 403,\n  \"message\": \"Rumble requires you to sign in to view this video's comments\"\n}\n```","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Rumble video URL."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://rumble.com/v792vns-the-splc-is-a-deceitful-and-poisonous-group.-but-was-their-behavior-crimina.html?e9s=rel_v2_ep"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"rumble","data":{"success":true,"id":"v792vns","numericId":434843840,"embedId":"v76w7nk","url":"https://rumble.com/v792vns-the-splc-is-a-deceitful-and-poisonous-group.-but-was-their-behavior-crimina.html","comments":[{"id":"609604348","text":"This is just like Jussie Smollett but on a huger scale -- if we can't find \"white supremacy,\" well, we'll just make that sh*t up. LOLLL","createdAt":"2026-04-27T22:20:00.000Z","createdAtText":"3 weeks ago","likeCount":15,"dislikeCount":0,"replyCount":2,"author":{"name":"robland","url":"https://rumble.com/user/robland","handle":"robland","avatar":null}}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/linkedin/profile":{"post":{"operationId":"social_linkedin_profile","x-nexscope-slug":"social-linkedin-profile","summary":"LinkedIn Person's Profile","description":"Retrieves a person's public LinkedIn profile data, including their name, photo, location, follower count (followers), about/bio summary, recent posts, work experience, education, articles, activity feed, publications, projects, recommendations, and similar profiles. Only returns publicly available information visible in an incognito browser. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. LinkedIn Person's Profile API View Pricing Get a public LinkedIn profile and recent posts as seen without login. Work history and job title are not publicly returned. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the LinkedIn profile to get"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.linkedin.com/in/parrsam/"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"linkedin","data":{"success":true,"name":"Sam Parr","image":"https://media.licdn.com/dms/image/v2/C4E03AQH3Vz1qV_rNVQ/profile-displayphoto-shrink_200_200/profile-displayphoto-shrink_200_200/0/1633389534107?e=2147483647&v=beta&t=8x4PIfTIYFOvpI1QRCDyAhNprZv0NY9kAp4EOdvUxLQ","location":"Westport, Connecticut, United States","followers":64803,"connections":"","about":"I founded The Hustle, a business news media company with $12 when I was around 25 years…","recentPosts":[{"title":"Super excited to watch the success of a company built by a Gauntlet AI grad: One missed contract renewal can cost your company $100k, $250k or more.…","activityType":"Posted by Austen Allred","link":"https://www.linkedin.com/posts/austenallred_super-excited-to-watch-the-success-of-a-company-activity-7333305862695919617-zTPI","image":"https://static.licdn.com/aero-v1/sc/h/53n89ecoxpr1qrki1do3alazb"}],"experience":[{"@type":"Organization","name":"Hampton","url":"https://www.linkedin.com/company/myhampton","location":"Austin, Texas Metropolitan Area","member":{"@type":"OrganizationRole","description":"******* ** * ****** ****** ********** ********* *** *************, ******** *** ****. <**><**>**'** ** * *** ****, *** ***...* *****.<**><**>*****://***.***********.***/"}}],"articles":[{"headline":"RANT: How to PROPERLY analyze risk","author":"Sam Parr","datePublished":"2017-09-17T13:08:55.000+00:00","image":"https://media.licdn.com/dms/image/v2/C5612AQG9YbLJodxr8g/article-cover_image-shrink_720_1280/article-cover_image-shrink_720_1280/0/1520096757452?e=2147483647&v=beta&t=USPma8tkR65yot8_Ye0zDfH2llLpTrZdZGHtbzmPjQ0","articleBody":"I've been talking to a few people who want to leave...."}],"activity":[{"title":"Othership is this cool suana place in NYC. The founder is hosting a bunch of Hampton members for a special session + a talk on how he built the…","activityType":"Shared by Sam Parr","link":"https://www.linkedin.com/posts/parrsam_exclusive-othership-session-qa-with-founder-activity-7328134812047704064-4NUL","image":"https://media.licdn.com/dms/image/sync/v2/D4D27AQGJaeiyu-gbrA/articleshare-shrink_1280_800/B4DZbLDrHUHsAU-/0/1747163460743?e=2147483647&v=beta&t=rZtGF2kjhFfLy-TZil0d_bakH4UfHnK-dcxEsrZSl5s"}],"education":[{"@type":"EducationalOrganization","name":"Belmont University","url":"https://www.linkedin.com/school/belmont-university/","member":{"@type":"OrganizationRole","startDate":2008,"endDate":2012}}],"publications":[{"name":"How my partner and I created a unique company in tough times","url":"http://online.wsj.com/article/SB10001424127887324694904578602013087282582.html&urlhash=SvYD"}],"projects":[{"name":"Hustle Con 2015","url":"https://www.linkedin.com/in/elizabethyin","dateRange":"2015","description":"","contributors":[{"name":"Elizabeth Yin","link":"https://www.linkedin.com/in/elizabethyin","image":"https://media.licdn.com/dms/image/v2/C5603AQFFdhmfyyiZig/profile-displayphoto-shrink_400_400/profile-displayphoto-shrink_400_400/0/1581292451105?e=2147483647&v=beta&t=IwghMTQZZjJzIGbN6e1IYfWVBDAkgLP_kSJJPOkzQDg"}]}],"recommendations":[{"name":"Jackie M.","link":"https://www.linkedin.com/in/jackiemooney","image":"https://static.licdn.com/aero-v1/sc/h/9c8pery4andzj6ohjkjp54ma2","text":"“I got to know Sam over 2 years of working at The Hustle. We grew from a company of 4 to 15 in that time and there was never a dull moment- anyone who knows Sam knows that he adds tons of energy to the workplace. This guy figures out what he wants to accomplish and makes it happen. He remains wildly driven and goal-oriented while constantly focused on both his personal and professional growth.”"}],"similarProfiles":[{"link":"https://ca.linkedin.com/in/stevemcody","name":"Steve Cody","image":"https://media.licdn.com/dms/image/v2/D5603AQEl17hna0u1ew/profile-displayphoto-shrink_400_400/profile-displayphoto-shrink_400_400/0/1673387873184?e=2147483647&v=beta&t=pN-Y2CS1AQ8AOKbTo_2_B0AXjof4nGLKBdhNZTfFYJA"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/linkedin/company":{"post":{"operationId":"social_linkedin_company","x-nexscope-slug":"social-linkedin-company","summary":"LinkedIn Company Page","description":"Fetches a LinkedIn company page with details including name, description, logo, cover image, slogan, location, headquarters, employee count (headcount/staff size), website, industry, company type, founded year, specialties, funding rounds with investors, featured employees, recent posts, and similar company pages. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. LinkedIn Company Page API View Pricing Get a LinkedIn company page 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the LinkedIn company page to get"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://linkedin.com/company/shopify"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"linkedin","data":{"success":true,"id":"784652","name":"Shopify","description":"Shopify is a leading global commerce company, providing trusted tools to start, grow, market, and manage a retail business of any size. Shopify makes commerce better for everyone with a platform and services that are engineered for reliability, while delivering a better shopping experience for consumers everywhere. Shopify powers millions of businesses in more than 175 countries and is trusted by brands such as Allbirds, Gymshark, PepsiCo, Staples, and many more.\n\nFind all our jobs here: www.shopify.com/careers","location":{"city":"Ottawa","state":"ON","country":"CA"},"employeeCount":23591,"website":"https://www.shopify.com","logo":"https://media.licdn.com/dms/image/v2/D560BAQG_KjTcNcrLVw/company-logo_200_200/B56ZZolTV.HUAU-/0/1745511331439/shopify_logo?e=2147483647&v=beta&t=D2saVg58cKnwEiDQgFgzvwL24mTRM_cPuU1ndv6kL2U","coverImage":"https://media.licdn.com/dms/image/v2/D563DAQGruQL8kvBvnw/image-scale_191_1128/B56ZanR4DSGoAs-/0/1746563203576/shopify_cover?e=2147483647&v=beta&t=rHubhVZZZSU_1V8tCeBpwL80OG3bNBjzBNEWFO24qa4","slogan":"Make commerce better for everyone","similarPages":[{"link":"https://www.linkedin.com/company/airbnb","name":"Airbnb","image":"https://media.licdn.com/dms/image/v2/C560BAQFhfl32crIGIw/company-logo_100_100/company-logo_100_100/0/1630637496980/airbnb_logo?e=2147483647&v=beta&t=idNQqoBZi6dZq6iG78J5GTOsNV_ltJf7ITo7zYZ6VWg"}],"industry":"Software Development","size":"10,001+ employees","founded":2006,"headquarters":"Ottawa, ON","type":"Public Company","specialties":["ecommerce"],"funding":{"numberOfRounds":4,"lastRound":{"type":"Series C","date":"2014-01-11T00:00:00.000Z","amount":"US$ 100.0M"},"investors":[{"name":"OMERS Ventures","crunchbaseUrl":"https://www.crunchbase.com/organization/omers-ventures","image":"https://media.licdn.com/dms/image/sync/v2/D4E38AQEnDf6SgPOjAQ/crunchbase_investor_logo_100/crunchbase_investor_logo_100/0/1748147400909?e=1749146400&v=beta&t=V974RcVsrtQI1mZcqXPoKT8kutQoYneu8pjbjm5Un8E"}]},"employees":[{"name":"\uD83C\uDDE8\uD83C\uDDE6 Todd Jefferson","title":"Staff Software Developer at Shopify","link":"https://ca.linkedin.com/in/toddjefferson","image":"https://media.licdn.com/dms/image/v2/C4E03AQHg-rFtEf9qpw/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1583259322606?e=2147483647&v=beta&t=uBFwlGCBbgFmwrP8f29P4nIDJCgZ1YEyyntBzpR9j30"}],"posts":[{"url":"https://www.linkedin.com/posts/shopify_shopifys-design-vision-brings-horizon-into-activity-7331699854873620480-R_N8","datePublished":"2025-05-23T15:17:41.770Z","text":"In the era of AI, design matters more than ever. And we’re not just keeping pace—we’re leading the way.\n\nDesigners at Shopify take an unconventional approach to the design process: embracing imperfection, doing the unorthodox, and obsessing over every detail. Roles are fluid and leads stay close to the craft.\n\nThe Summer ’25 Edition is so tactile you can practically feel it. It’s packed with interactive elements, fluid animations, and, as usual, a lot of Easter eggs. Horizon Drive is an homage to old driving games, straight out of an arcade. \n\nBut nothing this Edition captures our design vision more than Horizon. \n\nHorizon blends beautiful visuals with practical features that streamline the design process. No more scrolling and guessing. Just quick design choices and built-in AI to code the rest. \n\nShopify design leaders Maggie Fost, Kevin Clark, and Katarina﻿﻿ Batina﻿﻿ share how our design philosophy shaped the Summer ’25 Edition: https://lnkd.in/e-Q-DmCR"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/linkedin/company/posts":{"post":{"operationId":"social_linkedin_company_posts","x-nexscope-slug":"social-linkedin-company-posts","summary":"LinkedIn Company Posts","description":"Retrieves paginated posts from a LinkedIn company or school page, including each post's URL, ID, publication date, and full text content. Accepts /company/ and /school/ URLs, such as https://www.linkedin.com/school/oxfordsbs/ for Oxford Saïd Business School. Supports page-based pagination up to a maximum of 7 pages due to a LinkedIn platform limitation. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. LinkedIn Company Posts API View Pricing Get LinkedIn company or school posts by /company/ or /school/ URL. Limited to 7 pages by LinkedIn. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The LinkedIn company (/company/) or school (/school/) page URL, for example https://www.linkedin.com/school/oxfordsbs/"},"page":{"type":"number","description":"The page number to get"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://linkedin.com/company/shopify"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"linkedin","data":{"success":true,"posts":[{"url":"https://www.linkedin.com/posts/shopify_merchants-can-now-use-sidekick-voice-mode-activity-7429579034096726016-uX1e","id":"7429579034096726016","datePublished":"2026-02-17T17:34:36.617Z","text":"Merchants can now use Sidekick voice mode in the Shopify mobile app.\n\nOne of the first to try it out: Jimmy Donaldson, aka MrBeast.\n\nVoice mode makes it even easier to tackle tasks and get business insights on the go. It’s like having an AI-powered Shopify expert right in your pocket."}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/linkedin/search/posts":{"post":{"operationId":"social_linkedin_search_posts","x-nexscope-slug":"social-linkedin-search-posts","summary":"LinkedIn Search Posts","description":"Finds public LinkedIn posts, feed updates, and Pulse articles by keyword using Google Search, then returns post details such as description, author, media, images, like count, comment count, and published date when LinkedIn exposes them publicly. Results depend on what Google has indexed, so this is best-effort and not a complete LinkedIn-native search. Use date_posted for recent posts and pass the returned cursor to fetch the next page. Cursors are limited to pages 1 through 11; cursor 12 or greater returns a 400 response. Inline comments are only LinkedIn's public preview, not the full comment list; comment pagination is not available. Each comment includes nullable datePublished (the exact source timestamp, never estimated from age), publishedTimeAgo (how long ago the comment was published), urn (the full comment URN), id (the comment's numeric suffix as a string), and reactionCount (the source count, including 0). Pulse article previews may expose only age and identity, with null dates and reaction counts. These fields use the already-fetched page without additional upstream requests. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. LinkedIn Search Posts API View Pricing Search for public LinkedIn posts by keyword. Uses Google Search to find indexed posts, then scrapes the public LinkedIn pages. Comments are a public preview only, without comment pagination. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Keyword or phrase to search for in public LinkedIn posts"},"date_posted":{"type":"string","enum":["last-hour","last-day","last-week","last-month","last-year"],"description":"Date posted filter based on Google-indexed results"},"cursor":{"type":"string","description":"The cursor returned from the previous response. The maximum cursor is 11; cursor 12 or greater returns a 400 response."}},"required":["query"],"additionalProperties":false},"example":{"query":"ai agents"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"linkedin","data":{"success":true,"query":"ai agents","posts":[{"url":"https://www.linkedin.com/posts/aagupta_what-you-need-to-know-ai-agents-activity-7354600338621906944-RvXR","datePublished":"2025-07-25T19:56:02.566Z","description":"There's way too much hype about AI agents.\n\nHere's your simple guide:\n\nForget the super complex taxonomies out there. There are 4 categories of tools you should know.\n\n1. Consumer Agents\n\nThe latest LLMs, like Grok and Claude, have agents built-in. ChatGPT is rolling out the 'Agent' tool to paid plans as we speak.\n\nThese are best for:\n\n- Ad-hoc analysis\n- Quick research tasks\n- Content creation (PRDs, strategy docs)\n\n2. No-Code Agent Builders\n\nThere is a new class of tools that you must know. Tools like Zapier and Lindy offer where you can do things like connecting your Gmail to Claude.\n\nBe sure to explore these for:\n\n- Email triage\n- Competitor monitoring\n- Automated data reporting\n\n3. Developer-First Platforms\n\nAll the tools you've heard like CrewAI, Langchain, and Autogen are great frameworks for developers. Think of them as the React/Node for agents.\n\nThey're for:\n\n- Customer-facing agents\n- Deep system integrations\n- Complex, proprietary business logic\n\n4. Specialized Agent Apps\n\nTools like Cursor, Otter, and Jasper are specialized agent apps. They're supported by complex business logic to do one task really well.\n\nMy recommendations:\n\n- Coding → Cursor\n- Meetings → Otter AI\n- Research → Perplexity\n\nReady to go the layer deeper? I teamed up with AI PM at Meta Vikash Rungta to write you the web's most practical and simple guide: https://lnkd.in/eeey5Cxr\n\nPlease, let's end all the hype and talk real use cases.\n\nP.S. What agent are you using most?","media":"https://media.licdn.com/dms/image/v2/D4E1FAQHAzpgC7eaKgw/feedshare-document-images_160/B4EZhDHPPEGoAs-/1/1753472629037?e=1780531200&v=beta&t=7UAmCkScn1TSkvHB9HxLTPoBV7wibupD2WlKSec3ork","images":["https://media.licdn.com/dms/image/v2/D4E1FAQHAzpgC7eaKgw/feedshare-document-images_160/B4EZhDHPPEGoAs-/1/1753472629037?e=1780531200&v=beta&t=7UAmCkScn1TSkvHB9HxLTPoBV7wibupD2WlKSec3ork"],"image":"https://media.licdn.com/dms/image/v2/D4E1FAQHAzpgC7eaKgw/feedshare-document-images_160/B4EZhDHPPEGoAs-/1/1753472629037?e=1780531200&v=beta&t=7UAmCkScn1TSkvHB9HxLTPoBV7wibupD2WlKSec3ork","author":{"name":"Aakash Gupta","url":"https://www.linkedin.com/in/aagupta","image":"https://media.licdn.com/dms/image/v2/D5603AQGl7mUqMgCLRQ/profile-displayphoto-scale_200_200/B56Z3V9cKNKgAc-/0/1777411150180?e=2147483647&v=beta&t=oVB3kzDdrFGH-2pOYeziFk3m_B8fTCiH190YbTMrgoY","followers":313422},"comments":[{"author":"Lewin Wanzer","text":"Thanks for sharing, Aakash. Appreciate the breakdown—but here’s the twist most are missing: the AI agent is Agent Smith.\nThe more we chase “smart tasks” without structure, the more we lose the plot. Developers are confused. “AI Architects” don’t exist. And agents are now doing things they were never cleared to do.\nWe don’t need more tools—we need orchestration, identity-bound execution, and governed outcomes. Tourque will set the standard. Until that’s the norm, it’s just hype on autopilot.","linkedinUrl":"https://www.linkedin.com/in/lewinwanzer","datePublished":"2025-08-02T01:23:21.112Z","publishedTimeAgo":"1y","urn":"urn:li:comment:(urn:li:ugcPost:7354600336214376448,7357219423591563264)","id":"7357219423591563264","reactionCount":0}],"likeCount":217,"commentCount":25}],"cursor":"2"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/linkedin/post":{"post":{"operationId":"social_linkedin_post","x-nexscope-slug":"social-linkedin-post","summary":"LinkedIn Post","description":"Fetches a single LinkedIn post or article, returning the title, headline, full description text, author info with follower count, publication date, like count (reactions), comment count, and individual comments. For public feed posts, activityUrn and contentUrn expose LinkedIn's public activity and underlying share or ugcPost URNs when present; either can be null when LinkedIn does not expose it. Also includes related articles from the same author in moreArticles. Inline comments are only LinkedIn's public preview, not the full comment list; comment pagination is not available. Each comment includes nullable datePublished (the exact source timestamp, never estimated from age), publishedTimeAgo (how long ago the comment was published), urn (the full comment URN), id (the comment's numeric suffix as a string), and reactionCount (the source count, including 0). Pulse article previews may expose only age and identity, with null dates and reaction counts. These fields use the already-fetched page without additional upstream requests. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. LinkedIn Post API View Pricing Get a LinkedIn post or article. Comments are a public preview only, without comment pagination. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the LinkedIn post to get"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.linkedin.com/pulse/being-father-has-made-me-better-leader-vice-versa-austen-allred/"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"linkedin","data":{"success":true,"activityUrn":null,"contentUrn":null,"url":"https://www.linkedin.com/pulse/being-father-has-made-me-better-leader-vice-versa-austen-allred","name":"Being a Father Has Made me a Better Leader, and Vice Versa","headline":"It's not all that unique to be a 26-year-old founder in Silicon Valley. What was far more surprising to people in 2017 when I joined the S17 Y Combinator cohort is that I already had a family of my own.","commentCount":17,"likeCount":210,"datePublished":"2020-06-21T14:35:59.000+00:00","description":"It's not all that unique to be a 26-year-old founder in Silicon Valley. What was far more surprising to people in 2017 when I joined the S17 Y Combinator cohort is that I already had a family of my own. ....","author":{"name":"Austen Allred","url":"https://www.linkedin.com/in/austenallred","followers":30863},"comments":[{"author":"Jeremy M.","text":"Austen, thanks for sharing!","linkedinUrl":"https://uk.linkedin.com/in/jeremymurray","datePublished":null,"publishedTimeAgo":"1y","urn":"urn:li:comment:(urn:li:ugcPost:6680478363284512768,7325567567337566208)","id":"7325567567337566208","reactionCount":null}],"moreArticles":[{"link":"https://www.linkedin.com/pulse/note-outcomes-data-lambda-school-austen-allred","title":"A Note About Outcomes Data at Lambda School","datePublished":"Feb 24, 2020","description":"Due to some recent online media, there’s been some confusion recently about student outcomes at Lambda School - which…","reactionCount":168,"commentCount":15}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/linkedin/post/transcript":{"post":{"operationId":"social_linkedin_post_transcript","x-nexscope-slug":"social-linkedin-post-transcript","summary":"LinkedIn Post Transcript","description":"Fetches the transcript from a LinkedIn post video when LinkedIn exposes one publicly. Returns null with transcriptNotAvailable when the post has no transcript, and only deducts credits when a transcript is returned. Returned native captions cost 1 credit; empty transcripts and errors cost 0 credits. This endpoint does not use AI transcription. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. LinkedIn Post Transcript API View Pricing Get a LinkedIn post video's native transcript when available. 1 credit per request\nFetches the transcript from a LinkedIn post video when LinkedIn exposes one publicly. Returns null with transcriptNotAvailable when the post has no transcript, and only deducts credits when a transcript is returned. Returned native captions cost 1 credit; empty transcripts and errors cost 0 credits. This endpoint does not use AI transcription.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the LinkedIn post to get the transcript from"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.linkedin.com/posts/gemini-35-flash-is-a-step-forward-for-google-ugcPost-7465082215316525056-MHBd/"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"linkedin","data":{"success":true,"url":"https://www.linkedin.com/posts/artificial-analysis_gemini-35-flash-is-a-step-forward-for-google-activity-7465082408409870337-4Pm-","transcript":"Hey, my name is Declan Jackson. I am a member of technical staff here at Artificial Analysis and I'm going to do a quick chat through the recent release of Gemini 3.5 Flash...","transcriptNotAvailable":false},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/profile":{"post":{"operationId":"social_facebook_profile","x-nexscope-slug":"social-facebook-profile","summary":"Facebook Profile","description":"Retrieves public Facebook page details including category, address, email, phone, website, services, priceRange, rating, likeCount, talkingAboutCount, and followerCount. talkingAboutCount is nullable and only returned when Facebook exposes it publicly. Also returns adLibrary status with the page's ad activity and pageId. Optionally includes businessHours when get_business_hours is set to true. Contact fields come from the submitted public profile. To request removal of your own information from Scrape Creators results, email support@scrapecreators.com with the profile URL. If Facebook shows an 18+ content gate, the response is still 200 with account_status: \"age-restricted\" and isPrivate: true. If Facebook shows a private content gate, the response is still 200 with account_status: \"private\" and isPrivate: true. If the page is not found, the response is 404 with accountDoesNotExist: true and isPrivate: false. Set include_gated_profile=true to also return limited public fields (such as id, name, category, likeCount, profilePicSmall, and links) when a profile is gated or age-restricted. This option only affects gated/age-restricted profiles — public profiles still return the normal full response. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Profile API View Pricing Get public Facebook profile information 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Facebook profile URL"},"get_business_hours":{"type":"string","description":"Get the business's hours"},"include_gated_profile":{"type":"string","description":"When true, returns limited public fields for gated or age-restricted profiles. Ignored for normal public profiles — those still return the full response."},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.facebook.com/mantraindianfolsom"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook","data":{"success":true,"adLibrary":{"adStatus":"This Page is currently running ads.","pageId":"104359362513119"},"creationDate":"November 25, 2022","businessHours":[{"monday":{"open":null,"close":null,"intervals":[],"fullText":"CLOSED"}}],"id":"100088017857524","isPrivate":false,"name":"Mantraindian","url":"https://www.facebook.com/mantraindianfolsom","gender":"UNKNOWN","coverPhoto":{"focus":{"x":0.5,"y":0},"photo":{"id":"204402652503662","image":{"uri":"https://scontent.fist7-1.fna.fbcdn.net/v/t39.30808-6/477575273_596577106619546_7712360987777031655_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=111&ccb=1-7&_nc_sid=cc71e4&_nc_ohc=hroqQOZECdYQ7kNvwHW0J5L&_nc_oc=Adk2HkBhLO3HlnqMEN512H6bOO8kWLs9n2qaiqPc4ZLz5-wi2uBfzqlepnfKhx2hhhM&_nc_zt=23&_nc_ht=scontent.fist7-1.fna&_nc_gid=-tZvZl1NES4sMXJo89jIig&oh=00_AflZ2sbTeyQC-owdG-cOBdq99WVZuYH0HKLsj13NJ_UOPw&oe=6934FD62","width":960,"height":365},"viewer_image":{"height":780,"width":2050},"blurred_image":{"uri":"https://scontent.fist7-1.fna.fbcdn.net/v/t39.30808-6/477575273_596577106619546_7712360987777031655_n.jpg?stp=dst-jpg_fb50_s320x320_tt6&_nc_cat=111&ccb=1-7&_nc_sid=cc71e4&_nc_ohc=hroqQOZECdYQ7kNvwHW0J5L&_nc_oc=Adk2HkBhLO3HlnqMEN512H6bOO8kWLs9n2qaiqPc4ZLz5-wi2uBfzqlepnfKhx2hhhM&_nc_zt=23&_nc_ht=scontent.fist7-1.fna&_nc_gid=-tZvZl1NES4sMXJo89jIig&oh=00_Afn0vRutoAnfxCkPeQ0UNfSocrQwMLU8RATTjTchjbR90g&oe=6934FD62","width":320,"height":122},"url":"https://www.facebook.com/photo/?fbid=204402652503662&set=a.113593838251211"}},"isBusinessPageActive":false,"profilePhoto":{"url":"https://www.facebook.com/photo/?fbid=152234581053803&set=a.107432348867360","viewer_image":{"height":2000,"width":2000},"id":"152234581053803"},"profilePicLarge":"https://scontent.fist20-2.fna.fbcdn.net/v/t39.30808-1/331711173_3408886226056104_241444658713195527_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=110&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=eQc1mF5YvQ8Q7kNvwFj3Nmh&_nc_oc=AdlpRt4MVt6MwM7loElnrHIChk-vaLz0fxxzMR70TNaQBST-bDibHAZNHPFldgXd1go&_nc_zt=24&_nc_ht=scontent.fist20-2.fna&_nc_gid=-tZvZl1NES4sMXJo89jIig&oh=00_AflOlRBe-OV2xNqafE-cb2i0qvJfJ1yB21EebLXS_LKbQw&oe=693512A2","profilePicMedium":"https://scontent.fist20-2.fna.fbcdn.net/v/t39.30808-1/331711173_3408886226056104_241444658713195527_n.jpg?stp=dst-jpg_s148x148_tt6&_nc_cat=110&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=eQc1mF5YvQ8Q7kNvwFj3Nmh&_nc_oc=AdlpRt4MVt6MwM7loElnrHIChk-vaLz0fxxzMR70TNaQBST-bDibHAZNHPFldgXd1go&_nc_zt=24&_nc_ht=scontent.fist20-2.fna&_nc_gid=-tZvZl1NES4sMXJo89jIig&oh=00_Afl-VZWFU-_9jnKbqC0-2y--wYgnEAyFxIrSDSRl98Azkg&oe=693512A2","profilePicSmall":"https://scontent.fist20-2.fna.fbcdn.net/v/t39.30808-1/331711173_3408886226056104_241444658713195527_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=110&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=eQc1mF5YvQ8Q7kNvwFj3Nmh&_nc_oc=AdlpRt4MVt6MwM7loElnrHIChk-vaLz0fxxzMR70TNaQBST-bDibHAZNHPFldgXd1go&_nc_zt=24&_nc_ht=scontent.fist20-2.fna&_nc_gid=-tZvZl1NES4sMXJo89jIig&oh=00_AflavCQJIlrYTApZzkUMv1dDuld8v9j1ApqTtJkQrF32kQ&oe=693512A2","pageIntro":"Indian Vegan & Vegetarian Restaurant","category":"Restaurant","address":"1870 Prairie City Rd, Suite 500, Folsom, CA, United States, California","email":"contact@mantraindian.com","links":[],"phone":"+1 916-999-1749","website":"https://www.mantraindian.com/","services":"Delivery · Takeaway · Dine in…","priceRange":"$$","rating":"Not yet rated (1 review)","ratingCount":null,"likeCount":3224,"talkingAboutCount":418,"followerCount":3200},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/profile/reels":{"post":{"operationId":"social_facebook_profile_reels","x-nexscope-slug":"social-facebook-profile-reels","summary":"Facebook Profile Reels","description":"Fetches up to 10 reels per request from a public Facebook page. Each reel includes id, post_id, url, view_count, description, creation_time, video_url, thumbnail, play_time_in_ms, and music details. view_count comes from Facebook's public Reels badge (play_count_reduced), converted to a number; abbreviated values such as 27K become 27000, not an exact count. This list does not include like_count, reaction_counts, comment_count, share_count, or an is_pinned flag. Do not infer pinning from the order of returned reels. For available engagement metrics and a more precise view_count when Facebook exposes it, call /v1/facebook/post separately with each reel's returned url. There is no batch detail parameter on this endpoint. The detail view_count can still be null or lower than the public Reels badge. Pagination requires passing both next_page_id and cursor from the previous response. reels[].is_paid_partnership is a nullable boolean: true when Facebook supplies a paid-partnership label or an explicit paid branded-content relationship; null when unknown or no disclosure is supplied. It currently never returns false: a missing disclosure does not establish that a post has no sponsorship. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Profile Reels API View Pricing Get up to 10 page Reels. view_count is a possibly rounded badge count; use /v1/facebook/post per reel for engagement and available precise views. Paginate with next_page_id and cursor. 1 credit per request\nFetches up to 10 reels per request from a public Facebook page. Each reel includes id, post_id, url, view_count, description, creation_time, video_url, thumbnail, play_time_in_ms, and music details. view_count comes from Facebook's public Reels badge (play_count_reduced), converted to a number; abbreviated values such as 27K become 27000, not an exact count. This list does not include like_count, reaction_counts, comment_count, share_count, or an is_pinned flag. Do not infer pinning from the order of returned reels. For available engagement metrics and a more precise view_count when Facebook exposes it, call /v1/facebook/post separately with each reel's returned url. There is no batch detail parameter on this endpoint. The detail view_count can still be null or lower than the public Reels badge. Pagination requires passing both next_page_id and cursor from the previous response. reels[].is_paid_partnership is a nullable boolean: true when Facebook supplies a paid-partnership label or an explicit paid branded-content relationship; null when unknown or no disclosure is supplied. It currently never returns false: a missing disclosure does not establish that a post has no sponsorship.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Facebook page URL"},"next_page_id":{"type":"string","description":"To paginate through to the next page"},"cursor":{"type":"string","description":"To paginate through to the next page"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.facebook.com/pacemorby"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook","data":{"success":true,"reels":[{"id":"UzpfSTEwMDA2NDAyNzI0Mjg0OTpWSzoxMTE0MjM1OTIwNjY0NDA4","is_paid_partnership":null,"post_id":"1203161005161463","creation_time":"2025-09-13T20:51:28.000Z","url":"https://www.facebook.com/reel/1114235920664408","view_count":900,"feedback_id":"ZmVlZGJhY2s6MTIwMzE2MTAwNTE2MTQ2Mw==","description":"#globetheatreregina #GrandOpeningGlobeTheatre #yqrfood","video_id":"1114235920664408","thumbnail":"https://scontent.fsjc1-3.fna.fbcdn.net/v/t15.5256-10/548161090_781902490913426_4425148471361535737_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=104&ccb=1-7&_nc_sid=b5ba86&_nc_ohc=OSOOGTqjWBUQ7kNvwEELU_j&_nc_oc=AdlV3gLGZQ7yP7WZ71P40YFpkKZzQKTsoOwpia78XWC-552nlv0PaCzqp4JEN_eM8nw&_nc_zt=23&_nc_ht=scontent.fsjc1-3.fna&_nc_gid=RAC9UOMHIFPQvFPA49SzFw&oh=00_Afmww8iYxDtSamLiv7CnMMk5qN54iKlWRh3KGaQ9raX8sg&oe=6958CB0A","play_time_in_ms":22035,"video_url":"https://video.fsjc1-3.fna.fbcdn.net/o1/v/t2/f2/m366/AQOiS3S8KcKF2LNoPO0zOfAI3fDrZ4uUOgoNDGn6c7r8ABcujOm_egeBIp1UGt2C3T7bjmweRUAe6zZv183Qj3dpOTyUglIVsXGSEDb37A.mp4?_nc_cat=110&_nc_oc=AdlNlblWiTsxDyG87HyqrOExbMhSN5lMWCw0IbpBOlJvrHUyYOW84jgZapFBnh9ErN8&_nc_sid=8bf8fe&_nc_ht=video.fsjc1-3.fna.fbcdn.net&_nc_ohc=o6c-GAEZqSAQ7kNvwEDTAM6&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6MTE3MDg1MjU4ODIxOTYzMywiYXNzZXRfYWdlX2RheXMiOjEwNywidmlfdXNlY2FzZV9pZCI6MTAxMjAsImR1cmF0aW9uX3MiOjIyLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=RAC9UOMHIFPQvFPA49SzFw&_nc_zt=28&oh=00_AfnqnDcmg0X9m2W775vmpbH2-IrJvzz6gKDg-nHx1bUNwA&oe=6958DB58&bitrate=379965&tag=sve_sd","music":{"id":"1491450028648565","track_title":"The Copper Kettle Restaurant · Original audio"},"author":{"id":"100064027242849","name":"The Copper Kettle Restaurant","is_verified":false,"url":"https://www.facebook.com/copperkettleyqr","image":"https://scontent.fsjc1-3.fna.fbcdn.net/v/t39.30808-1/298528699_436705561807015_4191178501684731329_n.jpg?stp=cp0_dst-jpg_s40x40_tt6&_nc_cat=101&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=GrqhlAtcX98Q7kNvwFcfQYJ&_nc_oc=AdkVhSbfC7VUfqrXTTBHm1mAzqonpy9gE0aRcOV9-ddVxPsL4Nm-fnzbu7pTwhxuCuQ&_nc_zt=24&_nc_ht=scontent.fsjc1-3.fna&_nc_gid=RAC9UOMHIFPQvFPA49SzFw&oh=00_Aflr4kBQgljqP3wqJypUlzhoGQVCx4OyyBZW28kx1UDabw&oe=6958E99C"}}],"cursor":"AQHSiBn76EsmuU....","next_page_id":"YXBwX2NvbGxlY...."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/search/videos":{"post":{"operationId":"social_facebook_search_videos","x-nexscope-slug":"social-facebook-search-videos","summary":"Facebook Search Videos","description":"Searches Facebook's native public video search without a logged-in account and returns matching videos and Reels. This is not Google-indexed discovery or general Facebook text/photo-post search. Results follow Facebook's ranking and public availability, so coverage and ordering are not exhaustive or guaranteed. Requests can take several seconds; use a client timeout of at least 30 seconds. Temporary Facebook restrictions or upstream timeouts can return an uncharged error. Pass the returned cursor with the same query for the next page, and stop when cursor is null or has_more is false. Each successful search page costs 1 credit, including searches with no matches. Validation errors and upstream failures are not charged. videos[].is_paid_partnership is a nullable boolean: true when Facebook supplies a paid-partnership label or an explicit paid branded-content relationship; null when unknown or no disclosure is supplied. It currently never returns false: a missing disclosure does not establish that a post has no sponsorship. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Search Videos API View Pricing Search public Facebook videos and Reels by keyword, not text or photo posts. Each successful page costs 1 credit, even with no matches. 1 credit per request\nSearches Facebook's native public video search without a logged-in account and returns matching videos and Reels. This is not Google-indexed discovery or general Facebook text/photo-post search. Results follow Facebook's ranking and public availability, so coverage and ordering are not exhaustive or guaranteed. Requests can take several seconds; use a client timeout of at least 30 seconds. Temporary Facebook restrictions or upstream timeouts can return an uncharged error. Pass the returned cursor with the same query for the next page, and stop when cursor is null or has_more is false. Each successful search page costs 1 credit, including searches with no matches. Validation errors and upstream failures are not charged. videos[].is_paid_partnership is a nullable boolean: true when Facebook supplies a paid-partnership label or an explicit paid branded-content relationship; null when unknown or no disclosure is supplied. It currently never returns false: a missing disclosure does not establish that a post has no sponsorship.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"The keyword or phrase to search for"},"cursor":{"type":"string","description":"The opaque cursor returned by the previous response. Keep the query unchanged when paginating. Stop when cursor is null or has_more is false."}},"required":["query"],"additionalProperties":false},"example":{"query":"ai agents"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook","data":{"success":true,"query":"dogs","videos":[{"id":"1972139093484105","is_paid_partnership":null,"url":"https://www.facebook.com/reel/1972139093484105/","title":"Extremely strong dogs \uD83E\uDD8D","description":"You shouldn't underestimate the strength of your large dogs \uD83E\uDD8D#dog #bigdog #dogs #jozodogs #pet","author":{"id":"100071029295578","name":"Jozo Dogs","url":"https://www.facebook.com/jozodogs"},"creation_time":null,"publish_time":null,"relative_time_text":"Sep 5 · 89K views","duration_ms":null,"duration_text":"0:17","thumbnail_url":"https://scontent-lax3-2.xx.fbcdn.net/v/t15.5256-10/797452339_4437994959794452_2679783842489764932_n.jpg?stp=c0.83.206.115a_dst-jpg_p206x206_tt6&_nc_cat=111&ccb=1-7&_nc_sid=e3495b&_nc_ohc=xtv7jwiwuNQQ7kNvwEbj3vl&_nc_oc=AdoHeYyJmQ9f55LFZDTEnu_GlPQudlYYT5BGRCkZQvvXVaxUz4VgCyShthnifB9vaMs&_nc_zt=23&_nc_ht=scontent-lax3-2.xx&_nc_gid=r5QqvHq8oDddJgzN0OeHGw&_nc_ss=79180&oh=00_AQPGWtsD2mkz5PUZN7u9xH2PnLYfdYpmq2TeyIpwXdC3tA&oe=6AC8E5A4"}],"cursor":"eyJ...","has_more":true},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/profile/photos":{"post":{"operationId":"social_facebook_profile_photos","x-nexscope-slug":"social-facebook-profile-photos","summary":"Facebook Profile Photos","description":"Fetches photos from a public Facebook page with pagination support. Each photo includes photo_id, accessibility_caption, viewer_image with uri, height, and width, plus a thumbnail and direct url. Pagination requires passing both next_page_id and cursor from the previous response. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Profile Photos API View Pricing Get a public Facebook page's photos. Need 'next_page_id' and 'cursor' to paginate. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Facebook page URL"},"next_page_id":{"type":"string","description":"To paginate through to the next page"},"cursor":{"type":"string","description":"To paginate through to the next page"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.facebook.com/Spurs"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook","data":{"success":true,"photos":[{"id":"YXBwX2l0ZW06MTAwMDQ0NjM0NDUwMjA4OjIzMDUyNzI3MzI6NTo6MTQyODEwNjQwMjAyMDQ5NQ==","photo_id":"1428106402020495","accessibility_caption":"May be an image of basketball and text","immersive_photo_encodings":[],"viewer_image":{"uri":"https://scontent-sea5-1.xx.fbcdn.net/v/t51.82787-15/622604539_18555344569004556_8789920462640292891_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=127cfc&_nc_ohc=YhJA3Uo9mQwQ7kNvwF-U78r&_nc_oc=Adm4IWUCvbO4XHlgboz-L3jH_eVz1YgGx2VzBA43PLBLHQabFu5ZQY1pPHbHaDxTVXE&_nc_zt=23&_nc_ht=scontent-sea5-1.xx&_nc_gid=PY1yocAkrH2nITkFquluVw&oh=00_Afp4G33teGwLcRX96N3ulxHe9t0JgFHgnqW7JC-uGyHbtw&oe=69808C5B","height":1800,"width":1440},"photo_cix_screen":null,"thumbnail":"https://scontent-sea5-1.xx.fbcdn.net/v/t51.82787-15/622604539_18555344569004556_8789920462640292891_n.jpg?stp=c0.119.1440.1440a_dst-jpg_s206x206_tt6&_nc_cat=105&ccb=1-7&_nc_sid=714c7a&_nc_ohc=YhJA3Uo9mQwQ7kNvwF-U78r&_nc_oc=Adm4IWUCvbO4XHlgboz-L3jH_eVz1YgGx2VzBA43PLBLHQabFu5ZQY1pPHbHaDxTVXE&_nc_zt=23&_nc_ht=scontent-sea5-1.xx&_nc_gid=PY1yocAkrH2nITkFquluVw&oh=00_AfrRI7jPhILPra-iRKDUh-R3lQV3fbc1507ZhmDlZU0b6Q&oe=69808C5B","url":"https://www.facebook.com/photo.php?fbid=1428106402020495&set=pb.100044634450208.-2207520000&type=3"}],"cursor":"AQHSRM68MZ-AJKGSgRb0....","next_page_id":"YXBwX2NvbGxlY3Rpb24...."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/profile/posts":{"post":{"operationId":"social_facebook_profile_posts","x-nexscope-slug":"social-facebook-profile-posts","summary":"Facebook Profile Posts","description":"Returns publicly visible Facebook profile posts, limited to 3 posts per page due to API limitations. Each post includes id, text, url, reactionCount, commentCount, publishTime, videoDetails with sdUrl, hdUrl, and thumbnailUrl, plus topComments. Link shares can include link_attachment with url, title, description, source, and image_url; unavailable preview fields are null. Mixed photo/video posts retain their images and story url, with available video media in videoDetails and a video permalink. Accepts either a url or pageId parameter, where pageId is faster. posts[].is_paid_partnership is a nullable boolean: true when Facebook supplies a paid-partnership label or an explicit paid branded-content relationship; null when unknown or no disclosure is supplied. It currently never returns false: a missing disclosure does not establish that a post has no sponsorship. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Profile Posts API View Pricing Get public Facebook profile posts visible without login, 3 per page, with available link previews and video details. Provide url or pageId; pageId is faster. 1 credit per request\nReturns publicly visible Facebook profile posts, limited to 3 posts per page due to API limitations. Each post includes id, text, url, reactionCount, commentCount, publishTime, videoDetails with sdUrl, hdUrl, and thumbnailUrl, plus topComments. Link shares can include link_attachment with url, title, description, source, and image_url; unavailable preview fields are null. Mixed photo/video posts retain their images and story url, with available video media in videoDetails and a video permalink. Accepts either a url or pageId parameter, where pageId is faster. posts[].is_paid_partnership is a nullable boolean: true when Facebook supplies a paid-partnership label or an explicit paid branded-content relationship; null when unknown or no disclosure is supplied. It currently never returns false: a missing disclosure does not establish that a post has no sponsorship.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Facebook profile URL"},"pageId":{"type":"string","description":"Facebook profile page id"},"cursor":{"type":"string","description":"To paginate through the posts"}},"required":[],"additionalProperties":false},"example":{"url":"https://www.facebook.com/pacemorby"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook","data":{"success":true,"posts":[{"id":"1204545088344463","is_paid_partnership":null,"text":"I've had such a blast doing the No One Left Behind Challenge this year! Join me this Friday Dec 20 @ 5PM MST to learn about next month's challenge! https://subto.sjv.io/3Jk9Py","url":"https://www.facebook.com/reel/486651220706068/","permalink":"https://www.facebook.com/reel/486651220706068/","author":{"__typename":"User","name":"Pace Morby","short_name":"Pace Morby","id":"100063669491743"},"videoDetails":{"sdUrl":"https://video-atl3-2.xx.fbcdn.net/o1/v/t2/f2/m69/AQM-5pP3onM9DT-mhIF1lsU_5QIoHD3ezSh_534fSvquBk1J89JZc5j6cQzDP7ksAp5LQGEiJSVYnPWJVYmbgj42.mp4?strext=1&_nc_cat=111&_nc_sid=8bf8fe&_nc_ht=video-atl3-2.xx.fbcdn.net&_nc_ohc=myLadhBf0ekQ7kNvgH7M8Js&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzNlLjM2MC5zdmVfc2QiLCJ4cHZfYXNzZXRfaWQiOjExMjIwMjE0NDI4NDEyMTYsInZpX3VzZWNhc2VfaWQiOjEwMTIwLCJkdXJhdGlvbl9zIjo0MSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_zt=28&oh=00_AYEC_emahkqbCvG8fdT8745B6NgR005IOXFslY3cbX8vVQ&oe=67DBF193","hdUrl":"https://video-atl3-1.xx.fbcdn.net/o1/v/t2/f2/m69/AQPpb__shxY1O25oSbb2cYJJZdDS1uvPXNvL_wuUl3A5X4oczA14gCptufMdZIQ44Fa1nPHR7BJne11vQR0-kjxg.mp4?strext=1&_nc_cat=110&_nc_sid=5e9851&_nc_ht=video-atl3-1.xx.fbcdn.net&_nc_ohc=A8zHzpvkW7gQ7kNvgH7rC10&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzNlLjcxOC5kYXNoX2gyNjQtYmFzaWMtZ2VuMl83MjBwIiwieHB2X2Fzc2V0X2lkIjoxMTIyMDIxNDQyODQxMjE2LCJ2aV91c2VjYXNlX2lkIjoxMDEyMCwiZHVyYXRpb25fcyI6NDEsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=55aa7ea7f63fa16a&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HQ0RxRHh4LTh0cUt3UFlEQUw2b0RSdTQ0dXQyYm1kakFBQUYVAALIAQAVAhg6cGFzc3Rocm91Z2hfZXZlcnN0b3JlL0dKbUREeHpUY0l2OUotMERBRGd5RVFhbXo2OWZickZxQUFBRhUCAsgBACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJoCqv5ifnv4DFQIoA0MzZSwXQETe2RaHKwIYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUCAA&_nc_zt=28&oh=00_AYHZ0-S4uD1baiPZOqxXl42i74UuWxjyYp-k5Dr7yuQs8w&oe=67DBE6E0","thumbnailUrl":"https://scontent-atl3-1.xx.fbcdn.net/v/t15.5256-10/470601406_1890766051448666_5960639905933280594_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=110&ccb=1-7&_nc_sid=be8305&_nc_ohc=J2akzbIcN6YQ7kNvgG1IA8_&_nc_oc=AdjagDgUUwSzsa_e8vqInwXyyB57thjMdZ0w4daZ0kLaM1g4xZsv56Q-2REAPzOzDdesjbOxpKtxdUYKNQetO-u3&_nc_zt=23&_nc_ht=scontent-atl3-1.xx&_nc_gid=1q0R8aSRmKitPpFFDxvSfQ&oh=00_AYGj7VpqDzBwgIcAEKdSnqMq2IuwKqbNtTrpNKE6y5EsCQ&oe=67DBEC4D"},"reactionCount":133,"commentCount":12,"videoViewCount":null,"publishTime":1734553170,"topComments":[{"id":"Y29tbWVudDoxMjA0NTQ1MDg4MzQ0NDYzXzEzMDU4NDQ3ODM3NjA1ODk=","text":"How can I sign up?","publishTime":1734569761,"author":{"id":"pfbid02uDNsa8qhySfhQJ83VUcVD5mmVShgxNrtepNZ2TwCsg22xMN3NhdNBQbxPjj2dyr9l","name":"BeezMo Jenkins","gender":"MALE","url":null}}]}],"cursor":"Cg8Ob3JnYW5pY19jdXJzb3IJAAABxEFRSFI4N0N6eHZvYWlsRnJ3TlFMQTU4NUtmTzdSR2hQUzJpa25iTHlaMS1zbG1pTjZtTWFtN0JrNjB3UXVyUFFDOUJabC1JbjYwV2lhQmdqdTYzOXZTaHlMTGhIcGZXV21jRjVtZzBNY3dtSGlkLUNObnVFang4Ym1vYjVxSEZYYXBOZlVwSlVXVWpZbHF5X2xYODNGZzdNNmlIeUVCX1Yxb19ZLTEtanczRGJidm9XZDgxYlk0TmlaXzAtTm11T3dQZC1rY2FyVm44eERCYldjLTBEMXpxU1NCNG4wMjl1SHdaSmY2NjdURHJKUUxPcDRzZXFTZ3gzQk5JbTN5djRVNWQzMnFMMGp4Z3EtY1FWSFZMOWdKbUROQmR3TGx4c1dkWFpicnJlbUpsRVhqU0dodHNBS0tPcWZ2Q0U3QjFHbVhwbVluV3phMmdEMnBnVTZQTG5wMXhXMVAtQWQ2TVBCMXlMZGJlMUJGaHVYSWNpZEJnYUlwUXctSWgxZzhIVlBWZWhjbXJMTEVCVi1SSzRMQUJFZVcxcGR3Mm1YbzBiUjdWV1QyaDY0NmpYT1dHeDduSFZGWHdnM3pvZHpvNXEyTGxUDwlhZF9jdXJzb3IODw9nbG9iYWxfcG9zaXRpb24CAA8Gb2Zmc2V0AgAPEGxhc3RfYWRfcG9zaXRpb24C/wE="},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/profile/events":{"post":{"operationId":"social_facebook_profile_events","x-nexscope-slug":"social-facebook-profile-events","summary":"Facebook Profile Events","description":"Get the events of a public Facebook page Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Profile Events API View Pricing Get the events of a public Facebook page 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the public Facebook page"},"cursor":{"type":"string","description":"The cursor to paginate to get more events"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.facebook.com/brickyardoldtown"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook","data":{"success":true,"events":[{"id":"1596643298218453","__typename":"Event","name":"Harrison Steele at Brickyard","is_canceled":false,"event_creator":{"__typename":"User","__isEntity":"User","url":"https://www.facebook.com/brickyardoldtown","name":"Brickyard","id":"100066639371774"},"event_place":{"__typename":"FreeformPlace","contextual_name":"Brickyard","location":{"reverse_geocode":{"city":"Wichita"}},"__isNode":"FreeformPlace","id":"1594193222711146"},"day_time_sentence":"Thu, May 7 at 6:00 PM CDT","url":"https://www.facebook.com/events/1596643298218453/","gif_cover_photo":null,"cover_video":null,"__isEntity":"Event","event_kind":"PUBLIC_TYPE","is_happening_now":false,"is_online_or_detected_online":false,"is_past":false,"start_timestamp":1778194800}],"cursor":"eyJpZCI6IllYQ.....","has_next_page":true,"total_count":22},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/post":{"post":{"operationId":"social_facebook_post","x-nexscope-slug":"social-facebook-post","summary":"Facebook Post","description":"Retrieves a single public Facebook post or reel by URL. Use one request per reel, passing its returned /reel/ URL from /v1/facebook/profile/reels, to retrieve available like_count, reaction_counts, comment_count, share_count, and a more precise view_count when Facebook exposes it. This endpoint accepts a single URL, not a batch; exact views are not guaranteed. Returns post_id, like_count, comment_count, share_count, view_count, description, creation_time, and author details, including the author handle when Facebook exposes a vanity profile URL. For some reels, Facebook does not expose the same view count on the individual post page that it shows on the profile Reels grid. This value can be null or lower than the public Reels badge. If you need the public Reel badge count, call /v1/facebook/profile/reels with the author URL and match the reel by post_id. For video posts, includes video sd_url, hd_url, thumbnail, and length_in_second. Optionally fetches comments and transcript via get_comments and get_transcript parameters. is_paid_partnership is a nullable boolean: true when Facebook supplies a paid-partnership label or an explicit paid branded-content relationship; null when unknown or no disclosure is supplied. It currently never returns false: a missing disclosure does not establish that a post has no sponsorship. shared_post_id and shared_post_url identify the immediate post being shared when Facebook exposes it; both are nullable strings and are null when the reference is unavailable. Null does not prove the post is not a share. Existing id, post_id, and url values remain unchanged. The original is not automatically fetched, and these fields add no additional upstream requests. Call /v1/facebook/post with shared_post_url separately to retrieve the original's available media. Transcription is opt-in via get_transcript=true. Default short AI (up to 120 seconds, inclusive) is included in the existing base endpoint price, with no extra AI fee. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. On detail routes, successful paid-mode AI costs are in addition to the existing base endpoint cost; media-download pricing is unchanged. Returned native captions leave the base endpoint price unchanged. Empty AI results and errors incur no AI fee; the base scrape fee still applies when the detail scrape succeeds. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Post API View Pricing Get a public Facebook post or Reel, with shared_post_id and shared_post_url when exposed. Reel views may be null or below the badge; for badge counts, use /v1/facebook/profile/reels and match post_id. Exact views are not guaranteed. 1 credit per request\nRetrieves a single public Facebook post or reel by URL. Use one request per reel, passing its returned /reel/ URL from /v1/facebook/profile/reels, to retrieve available like_count, reaction_counts, comment_count, share_count, and a more precise view_count when Facebook exposes it. This endpoint accepts a single URL, not a batch; exact views are not guaranteed. Returns post_id, like_count, comment_count, share_count, view_count, description, creation_time, and author details, including the author handle when Facebook exposes a vanity profile URL. For some reels, Facebook does not expose the same view count on the individual post page that it shows on the profile Reels grid. This value can be null or lower than the public Reels badge. If you need the public Reel badge count, call /v1/facebook/profile/reels with the author URL and match the reel by post_id. For video posts, includes video sd_url, hd_url, thumbnail, and length_in_second. Optionally fetches comments and transcript via get_comments and get_transcript parameters. is_paid_partnership is a nullable boolean: true when Facebook supplies a paid-partnership label or an explicit paid branded-content relationship; null when unknown or no disclosure is supplied. It currently never returns false: a missing disclosure does not establish that a post has no sponsorship. shared_post_id and shared_post_url identify the immediate post being shared when Facebook exposes it; both are nullable strings and are null when the reference is unavailable. Null does not prove the post is not a share. Existing id, post_id, and url values remain unchanged. The original is not automatically fetched, and these fields add no additional upstream requests. Call /v1/facebook/post with shared_post_url separately to retrieve the original's available media. Transcription is opt-in via get_transcript=true. Default short AI (up to 120 seconds, inclusive) is included in the existing base endpoint price, with no extra AI fee. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. On detail routes, successful paid-mode AI costs are in addition to the existing base endpoint cost; media-download pricing is unchanged. Returned native captions leave the base endpoint price unchanged. Empty AI results and errors incur no AI fee; the base scrape fee still applies when the detail scrape succeeds. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nPaid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nTranscription is opt-in via get_transcript=true. Default short AI (up to 120 seconds, inclusive) is included in the existing base endpoint price, with no extra AI fee. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. On detail routes, successful paid-mode AI costs are in addition to the existing base endpoint cost; media-download pricing is unchanged. Returned native captions leave the base endpoint price unchanged. Empty AI results and errors incur no AI fee; the base scrape fee still applies when the detail scrape succeeds. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit; default short AI is included; allow_long_transcription=true adds 10 credits per started minute to the existing base cost). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the post to get"},"allow_long_transcription":{"type":"boolean","default":false,"description":"Paid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed."},"get_transcript":{"type":"boolean","description":"Transcription is opt-in via get_transcript=true. Default short AI (up to 120 seconds, inclusive) is included in the existing base endpoint price, with no extra AI fee. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. On detail routes, successful paid-mode AI costs are in addition to the existing base endpoint cost; media-download pricing is unchanged. Returned native captions leave the base endpoint price unchanged. Empty AI results and errors incur no AI fee; the base scrape fee still applies when the detail scrape succeeds. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed."},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit; default short AI is included; allow_long_transcription=true adds 10 credits per started minute to the existing base cost). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.facebook.com/reel/1535656380759655"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook","data":{"success":true,"post_id":"25118307061088489","shared_post_id":null,"shared_post_url":null,"is_paid_partnership":null,"like_count":2095,"comment_count":48,"share_count":133,"view_count":133000,"description":"Air Fryer Chocolate Cake \n\n100% f*cks, super simple and comes out gooey in the middle. \uD83C\uDF46 \n\n\uD83D\uDC68‍\uD83C\uDF73 Ingredients:\n✅ 1 large banana – 100 g (3.5 oz)\n✅ 80 g vanilla YoPro yogurt (2.8 oz / ⅓ cup)\n✅ 15 g Cadbury Bournville cocoa (0.5 oz / 1 tbsp)\n✅ 80 ml egg whites (2.7 fl oz / ⅓ cup)\n✅ 50 g oat flour (1.75 oz / ½ cup)\n✅ 1 tsp vanilla extract (5 ml)\n✅ ½ tsp baking powder (2.5 g)\n\uD83D\uDC49 Optional: 1 square dark chocolate (10 g / 0.35 oz, ~55 cals)\n\n\uD83D\uDD25 Method:\n 1. Mix banana, egg whites, yogurt, cocoa and vanilla until smooth\n 2. Stir in oat flour and baking powder\n 3. Pour into a ramekin or muffin tin\n 4. Add chocolate square to the centre if using\n 5. Air fry at 160°C / 320°F for 20 minutes\n\n\uD83D\uDCCA Macros (whole recipe):\nWithout choc: 378 cals | 27 g protein | 61.9 g carbs | 6 g fat\nWith choc: 433 cals | 27 g protein | 61.9 g carbs | 11.5 g fat\n\n\uD83D\uDCCA Macros (per serve — 2 serves):\nWithout choc: 189 cals | 13.5g protein | 31 g carbs | 3 g fat\nWith choc: 217 cals | 13.5 g protein | 31 g carbs | 5.8 g fat\n\nI also added low-calorie Peters ice cream and a small drizzle of Biscoff, but it honestly doesn’t need it. Tastes great on its own!\n\nIf you would like to make changes to this recipe yourself please do, but I like this EXACTLY the way it is. \uD83E\uDD1D\uD83E\uDEE1","creation_time":"2025-09-18T06:30:18.000Z","feedback_id":"ZmVlZGJhY2s6MjUxMDIxMDY3OTkzNzUxODI=","url":"https://www.facebook.com/reel/1535656380759655","image_url":null,"video":{"id":"1535656380759655","sd_url":"https://video-fml1-1.xx.fbcdn.net/o1/v/t2/f2/m69/AQPmP0-_mHv5cFqZShaBXjVeIgFmk-_1-6fll0qvoiw3O_StvDRD1FPZafKE0Mri9p94smEKiXpdPjrMnIk2qesQ.mp4?strext=1&_nc_cat=106&_nc_sid=8bf8fe&_nc_ht=video-fml1-1.xx.fbcdn.net&_nc_ohc=l9xG1fq_DpcQ7kNvwHsNBKh&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnByb2dyZXNzaXZlX2gyNjQtYmFzaWMtZ2VuMl8zNjBwIiwieHB2X2Fzc2V0X2lkIjo4MTEzOTQ4MTQ3NDY5NjAsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjoyMywidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=pXV0rbdIO2qXvelwzem88A&_nc_zt=28&oh=00_AfYY-br7Wa1JiPzs7_0vVr6SEV6zDf7qREmd6IV2xBGYMA&oe=68D239F0&bitrate=313736&tag=progressive_h264-basic-gen2_360p","hd_url":"https://video-fml1-1.xx.fbcdn.net/o1/v/t2/f2/m69/AQPvY-B_jtS_HwdB--AaOLTiMpw_euZ4QZoJbbh4iBl-faYyL6mYoumXJPqDF8qAnvZk8_SN5QOUds3tDfP0Bfa0.mp4?strext=1&_nc_cat=109&_nc_sid=8bf8fe&_nc_ht=video-fml1-1.xx.fbcdn.net&_nc_ohc=Z4s5wsMtW5wQ7kNvwFE0mwo&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuNzIwLnByb2dyZXNzaXZlX2gyNjQtYmFzaWMtZ2VuMl83MjBwIiwieHB2X2Fzc2V0X2lkIjo4MTEzOTQ4MTQ3NDY5NjAsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjoyMywidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=pXV0rbdIO2qXvelwzem88A&_nc_zt=28&oh=00_AfZJDoPCKtq3WW2VumFViHPpmIkGGqG34j9MWd9FmGrCVg&oe=68D25899&bitrate=1088662&tag=progressive_h264-basic-gen2_720p","height":1920,"width":1080,"length_in_second":23.36,"thumbnail":"https://scontent-fml1-1.xx.fbcdn.net/v/t51.82787-10/549761436_18521992156021539_7633323777597918486_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=103&ccb=1-7&_nc_sid=282d23&_nc_ohc=1LkTvLqxMhAQ7kNvwF2uUb7&_nc_oc=AdlKRAdNOj6ZDiga-3Zfj5bcwvfc68Lc39nsYJQ0hSPWGsRtUZJZ_sPCk25DrZJ2N98&_nc_zt=23&_nc_ht=scontent-fml1-1.xx&_nc_gid=pXV0rbdIO2qXvelwzem88A&oh=00_AfZy5UXtBdlEMJc6E6uLLiTvR15d344Nn4PO-wNA0cldQQ&oe=68D25528","captions_url":"https://scontent-fml1-1.xx.fbcdn.net/v/t39.2093-6/548496336_1535656704092956_4849526113470105591_n.srt?_nc_cat=105&ccb=1-7&_nc_sid=c211c2&_nc_ohc=IiEVsW2fSK0Q7kNvwEeCqpW&_nc_oc=AdmC4PNaIEGYuNZo_Qk6Qha6U8-ynQip-CKdvOrtQBRqTCrO8nOb6C5kABxPkLO4Vdc&_nc_zt=14&_nc_ht=scontent-fml1-1.xx&_nc_gid=pXV0rbdIO2qXvelwzem88A&oh=00_AfaJjBR2lJhhXTUO5hl0FWPGIlLxjVfuGMmTKUWSEtf6xA&oe=68D23D9F"},"author":{"id":"100000076236457","name":"Matt West","handle":"matt.west.184","is_verified":true,"url":"https://www.facebook.com/matt.west.184","image":"https://scontent-fml1-1.xx.fbcdn.net/v/t39.30808-1/485744182_9938984382780671_4072259528431711152_n.jpg?stp=cp0_dst-jpg_s40x40_tt6&_nc_cat=1&ccb=1-7&_nc_sid=1d2534&_nc_ohc=zu8xeHB9r5gQ7kNvwGWw84m&_nc_oc=AdkZ2Ef1ReB34aXLnnIpd4KHQ95nC0wAYS1GptVwcltvxMBjKXEU_D-mebY8WPwkhGI&_nc_zt=24&_nc_ht=scontent-fml1-1.xx&_nc_gid=pXV0rbdIO2qXvelwzem88A&oh=00_AfbFDYlovggVMiDAQp2_r7Ou-o0RG4T0VPbLMxVTfPlW7g&oe=68D250E6"},"music":{"id":"1506592770696336","type":"CUSTOM_AUDIO","track_title":"Matt West · Original audio","music_album_art":"https://scontent-fml1-1.xx.fbcdn.net/v/t39.30808-1/485744182_9938984382780671_4072259528431711152_n.jpg?stp=cp0_dst-jpg_s64x64_tt6&_nc_cat=1&ccb=1-7&_nc_sid=1d2534&_nc_ohc=zu8xeHB9r5gQ7kNvwGWw84m&_nc_oc=AdkZ2Ef1ReB34aXLnnIpd4KHQ95nC0wAYS1GptVwcltvxMBjKXEU_D-mebY8WPwkhGI&_nc_zt=24&_nc_ht=scontent-fml1-1.xx&_nc_gid=pXV0rbdIO2qXvelwzem88A&oh=00_AfZEGmsJmX51XXJTwXi90sPYazNybtjik0KhIFczr3jqIg&oe=68D250E6"}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/post/transcript":{"post":{"operationId":"social_facebook_post_transcript","x-nexscope-slug":"social-facebook-post-transcript","summary":"Facebook Transcript","description":"Returns the transcript text for a Facebook video post or reel. Existing transcripts or native captions are used first and cost 1 credit only when returned. Otherwise the public video is transcribed using AI. No transcript costs 0 credits. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Transcript API View Pricing Get native captions or an AI transcript from a Facebook video or Reel. Long AI transcripts may time out. Native captions or AI up to 2 minutes: 1 credit. Paid AI mode: 10 credits/minute, rounded up, even for short videos. No transcript: 0 credits.\nReturns the transcript text for a Facebook video post or reel. Existing transcripts or native captions are used first and cost 1 credit only when returned. Otherwise the public video is transcribed using AI. No transcript costs 0 credits. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nPaid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (Returned native captions cost 1 credit, even for long videos with the paid flag. By default, successful AI up to 120 seconds costs a flat 1 credit per request; over 120 seconds requires allow_long_transcription=true, which bills ALL successful AI at 10 credits per started minute, including short videos; empty AI results and errors cost 0 credits; no transcript: 0 credits). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Facebook post URL"},"allow_long_transcription":{"type":"boolean","default":false,"description":"Paid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed."},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (Returned native captions cost 1 credit, even for long videos with the paid flag. By default, successful AI up to 120 seconds costs a flat 1 credit per request; over 120 seconds requires allow_long_transcription=true, which bills ALL successful AI at 10 credits per started minute, including short videos; empty AI results and errors cost 0 credits; no transcript: 0 credits). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.facebook.com/reel/1535656380759655"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook","data":{"success":true,"transcript":"We're fishing\nbite x2\nBest bait\non this pole\nsomething else\nThere's a chance\ncan get a\nmythic pistol\nYou have to\nall game\nstill won't\nNuh uh\nliterally\nthe spawn\non it\n1 in 1000\nlike that\nWell watch\nright here\nGonna do it\nstream\nto finding\npistol\nto still lose with it\nThat was very\nvery much\nhoney\nthank you very much"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/post/comments":{"post":{"operationId":"social_facebook_post_comments","x-nexscope-slug":"social-facebook-post-comments","summary":"Facebook Comments","description":"Fetches comments from a Facebook post or reel with cursor-based pagination. Each comment includes id, text, created_at, reply_count, reaction_count, and author details with name and profile_picture. The attachments array contains image, GIF, video and sticker media when Facebook returns them, with type, id, url, preview_url, width and height. Text-only comments have an empty attachments array. Missing attachment values are null, and media URLs can expire. Passing a feedback_id instead of a url significantly speeds up the request. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Comments API View Pricing Get the comments of a Facebook post or reel, including image, GIF, video and sticker attachments when available. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Facebook post URL (or reel URL)"},"feedback_id":{"type":"string","description":"Using feedback_id (instead of url) will *really* speed up the request. You can get the feedback_id when you make a request to /v1/facebook/post."},"cursor":{"type":"string","description":"Cursor to get more comments. Get 'cursor' from previous response."}},"required":[],"additionalProperties":false},"example":{"url":"https://www.facebook.com/reel/753347914167361"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook","data":{"success":true,"comments":[{"id":"Y29tbWVudDoxMjA2OTAzNjAxNDgzOTYwXzc3OTIzNDI4MTE0NjkzNQ==","text":"Do 1/2 mini Oreos and 1/2 peanut butter ritz Bitz, otherwise the same recipe. It’s the BEST","created_at":"2025-09-01T01:10:40.000Z","reply_count":1,"reaction_count":95,"reactions":{"thankful":0,"like":79,"love":4,"care":0,"haha":1,"wow":11,"sad":0,"anger":0,"pride":0,"confused":0},"author":{"id":"pfbid02SdzVLPYTHY2eGMdrwFrLw54sVZdguAGnLUj4RPL3HxFtG2D4PBBjptiMEwpB21Ehl","name":"Robin Bergsagel","gender":"FEMALE","short_name":"Robin"}}],"cursor":"MToxNzc2NDYxMjMwOgF......","has_next_page":true},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/post/comment/replies":{"post":{"operationId":"social_facebook_post_comment_replies","x-nexscope-slug":"social-facebook-post-comment-replies","summary":"Facebook Comment Replies","description":"Get the replies to a comment with cursor-based pagination. Each reply includes an attachments array for image, GIF, video and sticker media that Facebook returns, with type, id, url, preview_url, width and height. Text-only replies have an empty attachments array. Missing attachment values are null, and media URLs can expire. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Comment Replies API View Pricing Get the replies to a comment, including image, GIF, video and sticker attachments when available. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"feedback_id":{"type":"string","description":"The *feedback_id* of the comment. Be careful, this is not the comment id. You can get the feedback_id from the /v1/facebook/post/comments endpoint."},"expansion_token":{"type":"string","description":"The expansion_token of the comment. You can get the expansion_token from the /v1/facebook/post/comments endpoint."},"cursor":{"type":"string","description":"The cursor to paginate to the next page"}},"required":["feedback_id","expansion_token"],"additionalProperties":false},"example":{"feedback_id":"ZmVlZGJhY2s6MzM3MzYxMzI5OTQ4Nzc1NV8xOTI5NTk0OTE3Njg3MTcz","expansion_token":"MjoxNzc4NjM1MDM3OgF_JaMa3kMP9RIWC...."}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook","data":{"success":true,"replies":[{"id":"Y29tbWVudDozMzczNjEzMjk5NDg3NzU1XzEyNzc0OTgwMjczODU4MzQ=","text":"Terry Quillan you must never had my famous sea turtle stew before","created_at":"2026-05-11T01:07:09.000Z","reply_count":17,"reaction_count":95,"reactions":{"thankful":0,"like":55,"love":3,"care":0,"haha":35,"wow":0,"sad":1,"anger":1,"pride":0,"confused":0},"author":{"id":"pfbid0urrhNfcV4eymBCwKXEk6tiCcCqEMFwkb9djy8EhnN9kipDcuhUzKLkN8qB8pt2gQl","name":"Raymond Hall","gender":"MALE","profile_picture":"https://scontent-lax3-1.xx.fbcdn.net/v/t39.30808-1/519542238_10229874106618644_5856796376173922928_n.jpg?stp=cp0_dst-jpg_s64x64_tt6&_nc_cat=104&ccb=1-7&_nc_sid=e99d92&_nc_ohc=NefHIXixvx4Q7kNvwHwl86J&_nc_oc=AdpROYopTKN75AL2mS_fiNyuXMA06F4RtyJbAJ8IVHwblJLpohfgxmZzkpO0y9z9cao&_nc_zt=24&_nc_ht=scontent-lax3-1.xx&_nc_gid=AIhHwdKlills_JoMczNbFQ&_nc_ss=7e289&oh=00_Af42yzOuNuXUZkDbwr_SsT6_6RluDyX1td_x-Xq3_z0lBA&oe=6A09B2F3"},"feedback_id":"ZmVlZGJhY2s6MzM3MzYxMzI5OTQ4Nzc1NV8xMjc3NDk4MDI3Mzg1ODM0","expansion_token":"MjoxNzc4NjM1MTIyOgF_1OrfwDkyxtMMlHVBMm_TzxlQ3yIAasPCWiOEh3uS5u2PAKQRSyqegVe-MsCSe1vnidBZ956FCNcsZjt-j0A69PCfGlR9brDaJDC-5J8nzZ7KF82vHzG3pFWQ5_1NzSXSkt9iwXJdr83oy-kbVXws_S1783yuDKbDZtA47mptn3WGGlDmkBKD4quDdh0QUd2bKjf8jyJz0YzKh7rCkGaAsq4eh4nZ6qsXeeUHAfN1NBtuM2_lp7Djg5eyTDAPN-W3jlICf1XwEj0h6LNnfEgZsjbSPTmVVJv5Q7_XjIkLAzFIGaX2xO89-KLJ3Ou32ZmX2wsiLBrhxkBCdW9ajr0vneAKmMDIpjHdjH3ll2B2s22xiMbtBG0Hz0dJwjFHnyVSbLDmYGzAWiLMpgQICCBWkS0rp7pNE6RodwXL9F5RVk4CwVPLtofERvLLFqvAvJ2291hFLxTTIXxveEZHhM8lD69YIE2cJrjNR5fOWyecvS4tYS_tB8aoy8Il-I3fAtsT0dlBgBuGgwO2RcFaQJc1"}],"cursor":"MToxNzc4NjM1MTIyOgF_w6rc3oH0....","has_next_page":true},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/group":{"post":{"operationId":"social_facebook_group","x-nexscope-slug":"social-facebook-group","summary":"Facebook Facebook Group Info","description":"Fetches the public information shown on a Facebook group's About page, including its description, privacy and visibility, member and activity counts, categories, administrators and moderators when Facebook exposes them, group history, and rules. Provide either url or group_id. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Facebook Group Info API View Pricing Get the public About-page information for a Facebook group. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The Facebook group URL. Group sub-page URLs such as /about work too."},"group_id":{"type":"string","description":"The numeric Facebook group ID. Provide this instead of url if you already have it."}},"required":[],"additionalProperties":false},"example":{"url":"https://www.facebook.com/groups/366190054572553/about"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook","data":{"success":true,"id":"366190054572553","url":"https://www.facebook.com/groups/366190054572553","name":"Python Programming","description":"Let's share our knowledge on Python Programming","privacy":{"label":"Public","description":"Anyone can see who's in the group and what they post."},"visibility":{"label":"Visible","description":"Anyone can find this group."},"categories":[{"id":"242504017103922","name":"Software & tech"}],"created_at":"2020-10-14T15:45:03.000Z","history_summary":"Group created on October 14, 2020. Name last changed on October 16, 2020.","member_count":710386,"member_count_text":"710,386 total members","administrator_count":3,"moderator_count":0,"administrators":[{"id":"pfbid029b9bjf9rZfL4v9EHdxt1uxng857G4UqwpZjbCHySg88UYWu2XL5ivSixWhXBnZMnl","name":"Nusrat Jahan","url":"https://www.facebook.com/people/Nusrat-Jahan/pfbid029b9bjf9rZfL4v9EHdxt1uxng857G4UqwpZjbCHySg88UYWu2XL5ivSixWhXBnZMnl/","profile_picture_url":"https://scontent.xx.fbcdn.net/example.jpg"}],"moderators":[],"activity":{"posts_last_day":16,"posts_last_month":512,"new_members_text":"No new members in the last week"},"rules":[{"id":"366191957905696","title":"Be Kind and Courteous","description":"We're all in this together to create a welcoming environment. Let's treat everyone with respect."}],"about_info":[{"type":"XFBPrivacyGroupsAboutInfoItem","label":"Public","description":"Anyone can see who's in the group and what they post."}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/group/posts":{"post":{"operationId":"social_facebook_group_posts","x-nexscope-slug":"social-facebook-group-posts","summary":"Facebook Facebook Group Posts","description":"Fetches posts from a public Facebook group, limited to 3 posts per page due to API limitations. Each post includes id, text, url, reactionCount, commentCount, publishTime, videoDetails, and topComments. Results are chronological by default. Supports TOP_POSTS, RECENT_ACTIVITY, CHRONOLOGICAL, and CHRONOLOGICAL_LISTINGS with cursor-based pagination. posts[].is_paid_partnership is a nullable boolean: true when Facebook supplies a paid-partnership label or an explicit paid branded-content relationship; null when unknown or no disclosure is supplied. It currently never returns false: a missing disclosure does not establish that a post has no sponsorship. shared_post_id and shared_post_url identify the immediate post being shared when Facebook exposes it; both are nullable strings and are null when the reference is unavailable. Null does not prove the post is not a share. Existing id, post_id, and url values remain unchanged. The original is not automatically fetched, and these fields add no additional upstream requests. Call /v1/facebook/post with shared_post_url separately to retrieve the original's available media. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Facebook Group Posts API View Pricing Get public Facebook group posts, with shared_post_id and shared_post_url when exposed. Facebook limits results to 3 per page. 1 credit per request\nFetches posts from a public Facebook group, limited to 3 posts per page due to API limitations. Each post includes id, text, url, reactionCount, commentCount, publishTime, videoDetails, and topComments. Results are chronological by default. Supports TOP_POSTS, RECENT_ACTIVITY, CHRONOLOGICAL, and CHRONOLOGICAL_LISTINGS with cursor-based pagination. posts[].is_paid_partnership is a nullable boolean: true when Facebook supplies a paid-partnership label or an explicit paid branded-content relationship; null when unknown or no disclosure is supplied. It currently never returns false: a missing disclosure does not establish that a post has no sponsorship. shared_post_id and shared_post_url identify the immediate post being shared when Facebook exposes it; both are nullable strings and are null when the reference is unavailable. Null does not prove the post is not a share. Existing id, post_id, and url values remain unchanged. The original is not automatically fetched, and these fields add no additional upstream requests. Call /v1/facebook/post with shared_post_url separately to retrieve the original's available media.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the group"},"group_id":{"type":"string","description":"The ID of the group"},"sort_by":{"type":"string","enum":["TOP_POSTS","RECENT_ACTIVITY","CHRONOLOGICAL","CHRONOLOGICAL_LISTINGS"],"description":"How to sort the posts. Defaults to CHRONOLOGICAL."},"cursor":{"type":"string","description":"The cursor to paginate to the next page"}},"required":[],"additionalProperties":false},"example":{"url":"https://www.facebook.com/groups/1270525996445602/"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook","data":{"success":true,"posts":[{"id":"1286289372828481","shared_post_id":null,"shared_post_url":null,"is_paid_partnership":null,"text":null,"url":"https://www.facebook.com/groups/742354120555345/permalink/1286289372828481/","permalink":"https://www.facebook.com/sofiyati.942655/videos/996458202287759/?idorvanity=742354120555345","author":{"__typename":"User","name":"Sofiyati","short_name":"Sofiyati","id":"61552766652796"},"reactionCount":198,"commentCount":100,"videoViewCount":null,"publishTime":1748639389,"videoDetails":{"sdUrl":"https://video-sea1-1.xx.fbcdn.net/o1/v/t2/f2/m69/AQO0_B24bEmILx4bmOfr_cQA5BgXwF9DMHJYAkUfQJAmuMGLV9PAc9-TrNen27lHJjr45pVm0ufFCcTJBCeFIr_s.mp4?strext=1&_nc_cat=111&_nc_sid=8bf8fe&_nc_ht=video-sea1-1.xx.fbcdn.net&_nc_ohc=paW12HBCn0EQ7kNvwFwJnXg&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzNlLjY0MC5zdmVfc2QiLCJ4cHZfYXNzZXRfaWQiOjEwNjkzNDUwMjg0MTg4MjYsInZpX3VzZWNhc2VfaWQiOjEwMTIxLCJkdXJhdGlvbl9zIjoxNSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_zt=28&oh=00_AfJNS34mvDAkIbtvP8o2nMuYrJ66ZeyCB1zQRlsD8sajow&oe=684150C7","hdUrl":"https://video-sea1-1.xx.fbcdn.net/o1/v/t2/f2/m69/AQM3UoTI5n6N2jVgKeUXSMPnqwAEQFHNGM9dejk3EV-MyBXNUcHlWtvYgUU2cD672EkWw5UAYZ3jJLXQiFdOvQh7.mp4?strext=1&_nc_cat=102&_nc_sid=5e9851&_nc_ht=video-sea1-1.xx.fbcdn.net&_nc_ohc=kSrgWXZVr9IQ7kNvwE16oSK&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzNlLjEyODAuZGFzaF9oMjY0LWJhc2ljLWdlbjJfNzIwcCIsInhwdl9hc3NldF9pZCI6MTA2OTM0NTAyODQxODgyNiwidmlfdXNlY2FzZV9pZCI6MTAxMjEsImR1cmF0aW9uX3MiOjE1LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=67dd4c5fe90b11c5&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HRUlZOHgwUVZ4azVjSHdIQUNGeU9XTzlQTzlXYm1kakFBQUYVAALIARIAFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HQ1V3OFIySHNmZWZhbUVFQUNZbmdLUlBMSzU4YnJGcUFBQUYVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmlLT9qImk5gMVAigDQzNlLBdALkQYk3S8ahgZZGFzaF9oMjY0LWJhc2ljLWdlbjJfNzIwcBEAdQJlkp4BAA&_nc_zt=28&oh=00_AfJKQedBwUVhnjLuJgGuJ7E1TXLk0vib17T3YkAmJUPb8w&oe=68414B6C","thumbnailUrl":"https://scontent-sea1-1.xx.fbcdn.net/v/t15.5256-10/502130835_1399930867890626_4491393707187246303_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=100&ccb=1-7&_nc_sid=50ce42&_nc_ohc=l5JdWBSutswQ7kNvwFHAOSM&_nc_oc=Adm5GttPwjsWvVb_d8d7buJHGnqW6FNHHuRyi2n0UmFWsS7KDF2bg4bo_0uXYI8Uxh0&_nc_zt=23&_nc_ht=scontent-sea1-1.xx&_nc_gid=BIqW4GLH6GWa7rMa2JiKFA&oh=00_AfKO58NMsMKO_OXEVSw8A1BNbt0xSVognLfCBKxypc5etw&oe=684150FC"},"topComments":[{"id":"Y29tbWVudDoxMjg2Mjg5MzcyODI4NDgxXzEyODY1MTY1MjYxMzkwOTk=","text":"I can find thousands of videos with the same exact trend. And we all know what I’m referring to \uD83E\uDD2D","publishTime":1748666375,"author":{"id":"pfbid0haqAQZCvs4cTVyfGwxCGPidvLYRNhFiboXkCH45LmPLAF1oQ7kJxaVig19KT8nZvl","name":"Trent Slushy","gender":"MALE","url":null}}]}],"cursor":"AQHRBjJCelNvdGRjH8s2j-...."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/github/user":{"post":{"operationId":"social_github_user","x-nexscope-slug":"social-github-user","summary":"GitHub User","description":"Retrieves public GitHub user details including name, bio, avatar, company, location, blog, follower counts, public repo counts, and account timestamps. Pass username, handle, or a full GitHub user url. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. GitHub User API View Pricing Get public GitHub user details for a user. Pass username, handle, or url. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"GitHub username/handle of the user you want the details for"},"url":{"type":"string","description":"GitHub user URL, e.g. https://github.com/torvalds."}},"required":[],"additionalProperties":false},"example":{"handle":"torvalds"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"github","data":{"success":true,"id":1024025,"node_id":"MDQ6VXNlcjEwMjQwMjU=","login":"torvalds","name":"Linus Torvalds","company":"Linux Foundation","blog":"","location":"Portland, OR","email":null,"bio":null,"twitter_username":null,"avatar_url":"https://avatars.githubusercontent.com/u/1024025?v=4","url":"https://github.com/torvalds","type":"User","site_admin":false,"public_repos":11,"public_gists":1,"followers":303973,"following":0,"created_at":"2011-09-03T15:26:22Z","updated_at":"2026-01-13T07:10:05Z"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/github/user/repositories":{"post":{"operationId":"social_github_user_repositories","x-nexscope-slug":"social-github-user-repositories","summary":"GitHub Repositories","description":"Retrieves a user's public repositories with repo metadata like description, language, stars, forks, topics, license, visibility, default branch, and timestamps. Pass username, handle, or url. Supports pagination with cursor, plus GitHub's type, sort, and direction parameters. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. GitHub Repositories API View Pricing Get public repositories for a GitHub user. Supports pagination and GitHub's repo sorting options. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"GitHub username/handle of the user you want the repositories for"},"url":{"type":"string","description":"GitHub user URL, e.g. https://github.com/kentcdodds."},"type":{"type":"string","enum":["owner","all","member"],"description":"Repository type. Defaults to owner. GitHub also supports all and member."},"sort":{"type":"string","enum":["created","updated","pushed","full_name"],"description":"Sort by created, updated, pushed, or full_name. Defaults to updated."},"direction":{"type":"string","enum":["asc","desc"],"description":"Sort direction: ascending or descending."},"cursor":{"type":"number","description":"Cursor from the previous response. Defaults to 1."}},"required":[],"additionalProperties":false},"example":{"handle":"torvalds"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"github","data":{"success":true,"repositories":[{"id":320393623,"node_id":"MDEwOlJlcG9zaXRvcnkzMjAzOTM2MjM=","name":"kentcdodds.com","full_name":"kentcdodds/kentcdodds.com","owner":{"id":1500684,"login":"kentcdodds","avatar_url":"https://avatars.githubusercontent.com/u/1500684?v=4","url":"https://github.com/kentcdodds","type":"User"},"private":false,"url":"https://github.com/kentcdodds/kentcdodds.com","description":"My personal website","fork":false,"homepage":"https://kentcdodds.com","language":"MDX","forks_count":654,"stars_count":2485,"watchers_count":2485,"size":53677,"default_branch":"main","open_issues_count":4,"topics":["kentcdodds"],"license":{"key":"other","name":"Other","spdx_id":"NOASSERTION"},"archived":false,"disabled":false,"visibility":"public","pushed_at":"2026-05-20T20:16:24Z","created_at":"2020-12-10T21:24:32Z","updated_at":"2026-05-21T16:43:37Z"}],"cursor":2},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/github/user/pull-requests":{"post":{"operationId":"social_github_user_pull_requests","x-nexscope-slug":"social-github-user-pull-requests","summary":"GitHub Pull Requests","description":"Searches public GitHub pull requests authored by a user using GitHub's public search index. Pass username, handle, or url. Optional since and until filters use YYYY-MM-DD created dates. Results include the PR title, repo, state, created_at, and url, sorted by newest created first. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. GitHub Pull Requests API View Pricing Get public pull requests authored by a GitHub user. Filter by created date with since and until. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"GitHub username/handle of the user you want pull requests for"},"since":{"type":"string","description":"Only return pull requests created on or after this date. Use YYYY-MM-DD."},"until":{"type":"string","description":"Only return pull requests created on or before this date. Use YYYY-MM-DD."},"cursor":{"type":"number","description":"Cursor from the previous response. Defaults to 1."}},"required":["handle"],"additionalProperties":false},"example":{"handle":"torvalds"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"github","data":{"success":true,"pull_requests":[{"title":"Garmin: Report correct local time offset","repo":"subsurface/libdc","state":"closed","created_at":"2024-12-26T20:13:25Z","url":"https://github.com/subsurface/libdc/pull/69"}],"cursor":2,"has_more":false},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/github/user/activity":{"post":{"operationId":"social_github_user_activity","x-nexscope-slug":"social-github-user-activity","summary":"GitHub Activity","description":"Retrieves GitHub profile contribution activity for a user from the public profile activity timeline. Defaults to the current year when year is not provided. Results come back one month at a time in the activity array. Pass cursor from the previous response to page backward through the year. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. GitHub Activity API View Pricing Get public GitHub profile contribution activity for a user. Defaults to the current year and returns one month at a time. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"GitHub handle"},"url":{"type":"string","description":"GitHub user URL, e.g. https://github.com/kentcdodds."},"year":{"type":"number","description":"When provided, returns profile contribution activity for that year. Defaults to the current year."},"cursor":{"type":"number","description":"Cursor from the previous response. Pages backward by month through the selected year."}},"required":[],"additionalProperties":false},"example":{"handle":"kentcdodds"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"github","data":{"success":true,"username":"kentcdodds","year":2026,"month":"May 2026","activity":[{"summary":"Created 186 commits in 13 repositories","details":[{"text":"kentcdodds/kody 144 commits","repository":{"text":"kentcdodds/kody","url":"https://github.com/kentcdodds/kody"},"links":[{"text":"kentcdodds/kody","url":"https://github.com/kentcdodds/kody"}],"language":null,"date_text":null,"date_description":null}]}],"no_activity":false,"message":null,"cursor":2},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/github/user/followers":{"post":{"operationId":"social_github_user_followers","x-nexscope-slug":"social-github-user-followers","summary":"GitHub Followers","description":"Retrieves public GitHub followers for a user. Each follower includes login, avatar, user URL, type, and GitHub IDs. Pass username, handle, or a full GitHub user url. Supports cursor pagination. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. GitHub Followers API View Pricing Get public followers for a GitHub user. Pass username, handle, or url. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"GitHub username/handle of the user you want the followers for"},"url":{"type":"string","description":"GitHub user URL, e.g. https://github.com/torvalds."},"cursor":{"type":"number","description":"Cursor from the previous response. Defaults to 1."}},"required":[],"additionalProperties":false},"example":{"handle":"torvalds"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"github","data":{"success":true,"followers":[{"id":206,"node_id":"MDQ6VXNlcjIwNg==","login":"sprsquish","avatar_url":"https://avatars.githubusercontent.com/u/206?v=4","url":"https://github.com/sprsquish","type":"User","site_admin":false}],"cursor":2},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/github/user/following":{"post":{"operationId":"social_github_user_following","x-nexscope-slug":"social-github-user-following","summary":"GitHub Following","description":"Retrieves public accounts followed by a GitHub user. Each account includes login, avatar, profile URL, type, and GitHub IDs. Pass username, handle, or a full GitHub profile url. Supports cursor pagination. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. GitHub Following API View Pricing Get public accounts a GitHub user follows. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"GitHub handle"},"url":{"type":"string","description":"GitHub profile URL"},"cursor":{"type":"number","description":"Cursor from the previous response. Defaults to 1."}},"required":[],"additionalProperties":false},"example":{"handle":"kentcdodds"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"github","data":{"success":true,"following":[{"id":4303,"node_id":"MDQ6VXNlcjQzMDM=","login":"jdalton","avatar_url":"https://avatars.githubusercontent.com/u/4303?v=4","url":"https://github.com/jdalton","type":"User","site_admin":false}],"cursor":2},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/github/user/contributions":{"post":{"operationId":"social_github_user_contributions","x-nexscope-slug":"social-github-user-contributions","summary":"GitHub Contributions","description":"Retrieves the public GitHub contribution graph for a user and year, including total contributions and daily contribution counts/intensity. Pass github handle, or a full GitHub profile url. Defaults to the current year when year is not provided. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. GitHub Contributions API View Pricing Get a user's GitHub contribution graph for a year. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"GitHub handle"},"url":{"type":"string","description":"GitHub profile URL"},"year":{"type":"number","description":"Contribution graph year. Defaults to the current year."}},"required":[],"additionalProperties":false},"example":{"handle":"torvalds"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"github","data":{"success":true,"contributions":{"username":"torvalds","year":2026,"total_contributions":1214,"days":[{"date":"2026-01-01","contribution_count":4,"color":null,"intensity":1}]}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/github/repository":{"post":{"operationId":"social_github_repository","x-nexscope-slug":"social-github-repository","summary":"GitHub Repository","description":"Retrieves public metadata for one GitHub repository, including owner, description, language, stars, forks, topics, license, visibility, default branch, open issues, and timestamps. Pass a full GitHub repository url. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. GitHub Repository API View Pricing Get public metadata for one GitHub repository. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"GitHub repository URL"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://github.com/torvalds/linux"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"github","data":{"success":true,"repository":{"id":2325298,"node_id":"MDEwOlJlcG9zaXRvcnkyMzI1Mjk4","name":"linux","full_name":"torvalds/linux","owner":{"id":1024025,"login":"torvalds","avatar_url":"https://avatars.githubusercontent.com/u/1024025?v=4","url":"https://github.com/torvalds","type":"User"},"private":false,"url":"https://github.com/torvalds/linux","description":"Linux kernel source tree","fork":false,"homepage":"","language":"C","forks_count":62423,"stars_count":233979,"watchers_count":233979,"size":6298741,"default_branch":"master","open_issues_count":3,"topics":[],"license":{"key":"other","name":"Other","spdx_id":"NOASSERTION"},"archived":false,"disabled":false,"visibility":"public","pushed_at":"2026-05-21T16:23:10Z","created_at":"2011-09-04T22:48:12Z","updated_at":"2026-05-21T19:31:40Z"}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/github/trending/repositories":{"post":{"operationId":"social_github_trending_repositories","x-nexscope-slug":"social-github-trending-repositories","summary":"GitHub Trending Repositories","description":"Scrapes GitHub's public Trending repositories page. Returns ranked repositories with public URLs, descriptions, language, star/fork counts, stars for the selected range, and built-by users when GitHub shows them. Use language for paths like JavaScript or Python, since for daily/weekly/monthly, and spoken_language_code for GitHub's spoken language filter. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. GitHub Trending Repositories API View Pricing Get GitHub trending repositories. Supports language, spoken_language_code, and daily/weekly/monthly range filters. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"language":{"type":"string","description":"Optional coding language, e.g. javascript, python, or go."},"since":{"type":"string","enum":["daily","weekly","monthly"],"description":"Trending range: daily, weekly, or monthly. Defaults to daily."},"spoken_language_code":{"type":"string","description":"Optional spoken language code filter, e.g. en."}},"required":[],"additionalProperties":false},"example":{}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"github","data":{"success":true,"since":"daily","language":null,"spoken_language_code":null,"repositories":[{"rank":1,"owner":"anthropics","repo":"claude-plugins-official","full_name":"anthropics/claude-plugins-official","url":"https://github.com/anthropics/claude-plugins-official","description":"Official, Anthropic-managed directory of high quality Claude Code Plugins.","language":"Python","language_color":"#3572A5","stars_count":22064,"forks_count":2627,"stars_today":891,"stars_today_text":"891 stars today","built_by":[{"username":"bryan-anthropic","avatar_url":"https://avatars.githubusercontent.com/u/238056179?s=40&v=4"}]}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/github/trending/developers":{"post":{"operationId":"social_github_trending_developers","x-nexscope-slug":"social-github-trending-developers","summary":"GitHub Trending Developers","description":"Scrapes GitHub's public Trending developers page. Returns ranked developers with username, name, public profile URL, avatar, and the popular repository GitHub shows for that developer when available. Use language for paths like javascript or python and since for daily/weekly/monthly. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. GitHub Trending Developers API View Pricing Get GitHub trending developers. Supports language and daily/weekly/monthly range filters. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"language":{"type":"string","description":"Optional trending coding language, e.g. javascript, python, or go."},"since":{"type":"string","enum":["daily","weekly","monthly"],"description":"Trending range: daily, weekly, or monthly. Defaults to daily."}},"required":[],"additionalProperties":false},"example":{}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"github","data":{"success":true,"since":"daily","language":null,"developers":[{"rank":1,"username":"koala73","name":"Elie Habib","url":"https://github.com/koala73","avatar_url":"https://avatars.githubusercontent.com/u/996596?s=96&v=4","popular_repository":{"owner":"koala73","repo":"worldmonitor","full_name":"koala73/worldmonitor","url":"https://github.com/koala73/worldmonitor","name":"worldmonitor","description":"Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified s…"}}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/marketplace/location/search":{"post":{"operationId":"social_facebook_marketplace_location_search","x-nexscope-slug":"social-facebook-marketplace-location-search","summary":"Facebook Marketplace Marketplace Location Search","description":"Searches Facebook Marketplace locations/cities and returns coordinates you can use with the Marketplace Search endpoint. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Marketplace Marketplace Location Search API View Pricing Searches Facebook Marketplace locations/cities and returns coordinates you can use with the Marketplace Search endpoint. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Location search query"}},"required":["query"],"additionalProperties":false},"example":{"query":"Austin"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook-marketplace","data":{"success":true,"locations":[{"name":"Austin","subtitle":"Austin, IL · 22,116 people checked in here","multi_line_address":[],"page_id":"108120015875983","latitude":41.894086,"longitude":-87.763202,"city":"Chicago","postal_code":"60644-1112"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/marketplace/search":{"post":{"operationId":"social_facebook_marketplace_search","x-nexscope-slug":"social-facebook-marketplace-search","summary":"Facebook Marketplace Marketplace Search","description":"Search Facebook Marketplace by keyword or browse a supported category without query. lat and lng are required. See category_id for allowed IDs. Pages usually contain about 24 listings and cost 1 credit, including empty filtered pages. Follow cursor as-is while has_next_page is true, keep inputs unchanged, and dedupe by listing id; keyword and category-only cursors cannot be mixed. Category-only date_listed, availability, and delivery_method filters apply to listing cards; condition requires a keyword. creation_time_descend is not strictly newest-first, and last_24_hours uses calendar days, not a rolling cutoff. creation_time (ISO 8601 UTC) and listing_date_text can be null. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Marketplace Marketplace Search API View Pricing Search Facebook Marketplace listings 1 credit per request\nSearch Facebook Marketplace by keyword or browse a supported category without query. lat and lng are required. See category_id for allowed IDs. Pages usually contain about 24 listings and cost 1 credit, including empty filtered pages. Follow cursor as-is while has_next_page is true, keep inputs unchanged, and dedupe by listing id; keyword and category-only cursors cannot be mixed. Category-only date_listed, availability, and delivery_method filters apply to listing cards; condition requires a keyword. creation_time_descend is not strictly newest-first, and last_24_hours uses calendar days, not a rolling cutoff. creation_time (ISO 8601 UTC) and listing_date_text can be null.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search keyword. Required unless category_id is provided."},"lat":{"type":"number","description":"Latitude for the search location"},"lng":{"type":"number","description":"Longitude for the search location"},"category_id":{"type":"string","description":"Category ID from listing results. Omit query to browse a category below.\n\nAllowed IDs for keyword-free browsing:\n- Antiques: 393860164117441\n- Appliances: 678754142233400\n- Bicycles: 1658310421102081\n- Boats: 712638205822882\n- Electronics: 1792291877663080\n- Furniture: 1583634935226685\n- Garden: 800089866739547\n- Household: 1569171756675761\n- Tools: 1670493229902393\n- Trailers: 655837954899686\n- Vehicles: 807311116002614\n- Vehicles (alternate ID): 546583916084032\n\nOther category IDs, including Housing, Food, and Services, require a keyword."},"radius_km":{"type":"number","description":"Search radius in kilometers"},"min_price":{"type":"number","description":"Minimum listing price"},"max_price":{"type":"number","description":"Maximum listing price"},"sort_by":{"type":"string","enum":["suggested","distance_ascend","creation_time_descend","price_ascend","price_descend"],"description":"Facebook Marketplace sort option. creation_time_descend usually orders the first pages newest first, but Facebook can insert newer listings on later cursor pages."},"delivery_method":{"type":"string","enum":["all","local_pickup","shipping"],"description":"Delivery filter"},"condition":{"type":"string","enum":["new","used_like_new","used_good","used_fair"],"description":"Condition filter"},"date_listed":{"type":"string","enum":["all","1","7","30","last_24_hours","last_7_days","last_30_days"],"description":"Facebook Marketplace date filter. Uses the same calendar-day buckets as the UI, so last_24_hours can include listings from the prior calendar day."},"availability":{"type":"string","enum":["available","sold","all"],"description":"Availability filter"},"cursor":{"type":"string","description":"Opaque pagination cursor returned from the previous response. Pass it back as-is."}},"required":["lat","lng"],"additionalProperties":false},"example":{"query":"iphone","lat":30.2677,"lng":-97.7475}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook-marketplace","data":{"success":true,"listings":[{"id":"1880804689276480","url":"https://www.facebook.com/marketplace/item/1880804689276480/","title":"ANCHEER E Bike","creation_time":null,"listing_date_text":null,"price":{"formatted_amount":"$300","amount_with_offset_in_currency":30000,"amount":300},"strikethrough_price":null,"location":{"city":"Austin","state":"TX","display_name":"Austin, Texas","city_page_id":"106224666074625"},"primary_photo":{"id":"742022888999863","url":"https://scontent-bos5-1.xx.fbcdn.net/v/t39.84726-6/696326464_742022902333195_6718077421452400338_n.jpg?stp=c43.0.260.260a_dst-jpg_p261x260_tt6&_nc_cat=106&ccb=1-7&_nc_sid=92e707&_nc_ohc=dzY2b4-6EowQ7kNvwFDgohs&_nc_oc=AdomRHPRV49gouEOWqxlFxuEeLcoc5cBjRhXhi91oslqlUNdZ9EV-te1C_pvL-eyVzs&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=GvS1066o3EBgpWuqL6BQZA&_nc_ss=7e289&oh=00_Af6M2kbWMsKLjEHmSUv6oiPJt3skIfetxG3oB2YOIiDuTg&oe=6A0D6E08"},"category_id":"1658310421102081","is_hidden":false,"is_live":true,"is_pending":false,"is_sold":false,"is_viewer_seller":false,"delivery_types":["IN_PERSON"],"story_type":"POST","story_key":"26881002338175809"}],"cursor":"eyJwZyI6MCwiYjJj....","has_next_page":true},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/marketplace/item":{"post":{"operationId":"social_facebook_marketplace_item","x-nexscope-slug":"social-facebook-marketplace-item","summary":"Facebook Marketplace Marketplace Item","description":"Fetches details for a Facebook Marketplace item by item id or Marketplace item URL, including title, description, price, location, condition, photos, seller, and availability flags. Rental listings can include listing_date_text and availability_text from Facebook's Marketplace GraphQL response, for example 'Listed over a week ago' and 'Available now'. creation_time can still be null when Facebook does not expose an exact timestamp. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Marketplace Marketplace Item API View Pricing Get a Facebook Marketplace item, including rental listing_date_text and availability_text when Facebook exposes them. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Facebook Marketplace item id"},"url":{"type":"string","description":"Facebook Marketplace item URL"}},"required":[],"additionalProperties":false},"example":{"url":"https://www.facebook.com/marketplace/item/1656586118821988/"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook-marketplace","data":{"success":true,"id":"1656586118821988","url":"https://www.facebook.com/marketplace/item/1656586118821988/","title":"Specialized Hardrock GSX - Super Clean Vintage Restomod - INCLUDES FREE TUNE UP","description":"Was going to hang on to this one bc I absolutely love how it looks, but the 20” frame is just bit too large for me. Riders over 6’ would be comfy on this one. Currently in a 3x7 set up with an XT derailleur at the rear. Looks great in person. Come ride it!  These never last long. \n\nCASH ONLY, PLEASE. NEAR 183/BRAKER.  \n\n$380 OBO. \n\nKey points:\n\n- Maxxis DTH tires (26”)\n- Shimano Deore XT rear derailleur \n- Shimano front derailleur\n- vintage Specialized steel frame (20”)\n- vintage Sakae triple crankset (170mm)\n- vintage Sakae SR Custom handlebar\n- vintage Suntour stem shifter\n- vintage Shimano brakes\n- Specialized Avatar 143 saddle\n- new chain\n- fresh cables\n- fresh housing\n- fresh grease and lube\n- fresh lube in cable housings\n- fresh handlebar tape\n- drive train cleaned and lubed\n- derailluers adjusted and fine tuned\n- brakes adjusted and fine tuned\n- deep cleaning/detail\n- frame polished\n- frame waxed\n- INCLUDES ONE FREE TUNE UP\n","creation_time":"2026-05-15T16:57:39.000Z","listing_date_text":null,"availability_text":null,"location_text":"Austin, TX","location":{"latitude":30.401916503906,"longitude":-97.761840820312},"price":{"formatted_amount_zeros_stripped":"$380","amount_with_offset_in_currency":38000,"amount":380,"currency":"USD"},"strikethrough_price":null,"category_id":"1658310421102081","attributes":[{"attribute_name":"Condition","value":"used_good","label":"Used - Good"}],"photos":[{"id":"2810586442651711","url":"https://scontent-bos5-1.xx.fbcdn.net/v/t39.84726-6/701290950_2810586459318376_3780262866029042186_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=111&ccb=1-7&_nc_sid=92e707&_nc_ohc=ROKufyRtfXsQ7kNvwGcXi_k&_nc_oc=Adr-1I--Ur89Efziu4LbR01Gx7vv7Ky2iQDaspacjs93wQf7O21Zucf8Bqk7JnAV9us&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=I5XX4xnX65bx3IZ1QXZ0oQ&_nc_ss=7e289&oh=00_Af4qBsmM1VtSMQvu_Uq9lP5B3sZDkmH3d7tcnkb4qJrfvQ&oe=6A0D43D6","width":960,"height":720,"accessibility_caption":"No photo description available."}],"is_hidden":false,"is_live":true,"is_pending":false,"is_sold":false,"is_viewer_seller":false,"is_shipping_offered":false,"is_buy_now_enabled":false,"messaging_enabled":true,"delivery_types":["IN_PERSON"],"share_uri":"https://www.facebook.com/marketplace/item/1656586118821988/","seller":null},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/events/search":{"post":{"operationId":"social_facebook_events_search","x-nexscope-slug":"social-facebook-events-search","summary":"Facebook Events Search Events","description":"Search for events by name. You can take a look at the page from Facebook we are getting the data from [here](https://www.facebook.com/events/search/?q=dogs) Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Events Search Events API View Pricing Search public Facebook events by name. Source page . 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"The query to search for"},"cursor":{"type":"string","description":"The cursor to paginate to the next page"}},"required":["query"],"additionalProperties":false},"example":{"query":"Event name or description"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook-events","data":{"success":true,"events":[{"id":"24659081027102562","name":"DockDogs® at Frankenmuth Dog Bowl","type":"Event","url":"https://www.facebook.com/events/24659081027102562/","day_time_sentence":"Fri, May 22 - May 24","event_place":{"__typename":"FreeformPlace","contextual_name":"Frankenmuth River Place Shops","__isNode":"FreeformPlace","id":"1455187729296539"},"ticketing_context_row":{"price_range_text":null},"is_online":false,"is_past":false,"event_url":"https://www.facebook.com/events/24659081027102562/","event_kind":"PUBLIC_TYPE","start_timestamp":1779480000,"cover_photo":{"accessibility_caption":"No photo description available.","eventImage":{"uri":"https://scontent-bos5-1.xx.fbcdn.net/v/t39.30808-6/593531570_1415564506592195_6877452715877012878_n.jpg?stp=dst-jpg_p75x225_tt6&_nc_cat=108&ccb=1-7&_nc_sid=7e0d18&_nc_ohc=lfZDvDmA5TgQ7kNvwGAJ9kC&_nc_oc=AdpiWd2PvIAUMK-DqCWA4v5iUaC2q5pKzs1BCjIS2OfxuyITVAF4rXXCFbes2A7jTTI&_nc_zt=23&_nc_ht=scontent-bos5-1.xx&_nc_gid=Bc1EYqxenHsF96t4Z7ZTbQ&_nc_ss=7e289&oh=00_Af7QI7ClZW5fpMopR2xSaj3wB0Md9w9Hw1dVS5jLWhSbTw&oe=69FCA6B5"},"id":"1415564503258862"},"social_context":{"text":"21 interested · 10 going","interested_count":21,"going_count":10,"went_count":null}}],"cursor":"Abr1gHMU6H...."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/events":{"post":{"operationId":"social_facebook_events","x-nexscope-slug":"social-facebook-events","summary":"Facebook Events Events","description":"Get the events of a city. Check out this [link](https://www.facebook.com/events/explore/saint-petersburg-florida/111326725552547) for an example of where we are getting the data from. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Events Events API View Pricing Get events from a city's Facebook Events page. Example source . 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the city's Facebook Events page"},"time":{"type":"string","enum":["today","this_week","next_week"],"description":"The time frame to search for. Defaults to all time"},"cursor":{"type":"string","description":"The cursor to paginate to the next page"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.facebook.com/events/explore/saint-petersburg-florida/111326725552547"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook-events","data":{"success":true,"events":[{"id":"2255360061870188","schema_context":null,"cover_photo":{"photo":{"accessibility_caption":"May be an image of crowd","image":{"uri":"https://scontent-bos5-1.xx.fbcdn.net/v/t39.30808-6/651106377_950305721046361_5055393414866459656_n.jpg?stp=c0.128.2048.977a_dst-jpg_s640x640_tt6&_nc_cat=102&ccb=1-7&_nc_sid=7e0d18&_nc_ohc=uoUS18WdA8AQ7kNvwFst0pe&_nc_oc=AdrKSULesf0R7do30SFyq0RoMV3ZxJYTz5leueITbRx88Cbg1yRFOKo-d1-yMT01j68&_nc_zt=23&_nc_ht=scontent-bos5-1.xx&_nc_gid=qD91MpaVYDRFp7bLWxiBHg&_nc_ss=7e289&oh=00_Af5VIYxAG3h_o7zT5ilskEWnNSJsEIbKRSi0j0G8xTorjA&oe=69FC8B8B"},"id":"950305717713028"}},"cover_video":null,"gif_cover_photo":null,"online_event_setup":null,"is_happening_now":false,"day_time_sentence":"Sun, May 3 at 12:00 PM EDT","name":"May St. Pete Flea ","is_online":false,"ticketing_context_row":{"price_range_text":null},"event_place":{"__typename":"Page","contextual_name":"Mirror Lake Park, Downtown St Pete","__isNode":"Page","id":"521768081246129"},"eventUrl":"https://www.facebook.com/events/2255360061870188/","can_page_viewer_invite_as_user":false,"can_viewer_invite":false,"can_viewer_rsvp":false,"can_viewer_share":false,"event_kind":"PUBLIC_TYPE","if_viewer_can_duplicate_event":null,"is_online_or_detected_online":false,"is_past":false,"is_viewer_host":false,"start_timestamp":1777824000,"rsvp_button_renderer":{"__typename":"PublicRsvpStyleRenderer","event":{"id":"2255360061870188","connection_style":"INTERESTED","can_viewer_join":false,"can_viewer_watch":false,"can_viewer_unwatch":false,"viewer_watch_status":"UNWATCHED","if_viewer_can_see_going_button":null,"event_connection_data_privacy_scope":null,"privacy_scope_for_toast":null,"can_join_group_chat":false,"created_for_group":null,"chat":null},"__module_operation_EventCometUniversalRSVPButton_event":{"__dr":"PublicEventCometRSVPButtonRenderer_rsvpStyleRenderer$normalization.graphql"},"__module_component_EventCometUniversalRSVPButton_event":{"__dr":"PublicEventCometRSVPButtonRenderer.react"}},"parent_if_exists_or_self":{"online_event_setup":null,"id":"2255360061870188"},"live_virtual_event_info":null,"__typename":"Event","social_context":{"text":"7.3K interested · 195 going","ranges":[],"interested_count":7300,"going_count":195,"went_count":null}}],"cursor":"eyJzdGFydF...."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/event/details":{"post":{"operationId":"social_facebook_event_details","x-nexscope-slug":"social-facebook-event-details","summary":"Facebook Events Event Details","description":"Get a specific event by its URL or id Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Events Event Details API View Pricing Get a specific event by its URL or id 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the event"},"url":{"type":"string","description":"The URL of the event"}},"required":[],"additionalProperties":false},"example":{"url":"https://www.facebook.com/events/2255360061870188/"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook-events","data":{"success":true,"id":"2255360061870188","url":"https://www.facebook.com/events/2255360061870188/","name":"May St. Pete Flea ","description":"SPRING IS HERE AND WE CAN’T WAIT TO SEE YOU AT THE MARKET! \nMeet us downtown at Mirror Lalke as we host some of the best makers, artists and small businesses in the Tampa Bay area. \n\nWe have three great dates this spring to shop with us as we bring you best Tampa Bay has to offer in locally made and curated hand-crafted goods, vintage housewares, decor, Mid-century furniture, vintage clothing, antiques, plants, collectables, food, music, art and so much more.  \n\nSunday, March 8th, 2026\nSunday, April 12th, 2026\nSunday, May 3rd, 2026\n********\n12:00 p.m. - 4:00 p.m.�Free to the Public * Family Friendly *\n\n* LOCATION *\nThe market will be held out in Downtown St. Petersburg, in front of our beautiful City Hall and Courthouse, right next to Mirror Lake.","category":null,"categories":[],"is_online":false,"is_past":true,"event_kind":"PUBLIC_TYPE","privacy":"public","start_time":null,"end_time":null,"time_text":null,"duration":"4 hr","price":null,"ticket_url":null,"ticket_source":null,"ticket_provider":null,"location_name":"Mirror Lake Park, Downtown St Pete","address":"Saint Petersburg, FL","city":"Saint Petersburg, Florida","city_id":"111326725552547","latitude":27.776053761243,"longitude":-82.639546684316,"attendance_count":7654,"attendance_facepile_count":0,"can_view_members":true,"host_context_text":"Event by The Indie Flea","hosts":[{"id":"100082008263628","name":"The Indie Flea","type":"User","url":"https://www.facebook.com/theindieflea","is_verified":false,"profile_picture_url":"https://scontent-lga3-3.xx.fbcdn.net/v/t39.30808-1/464183650_549071584503112_3055385531133902634_n.jpg?stp=cp0_dst-jpg_s74x74_tt6&_nc_cat=104&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=5rQ_jTw3GmkQ7kNvwG062e2&_nc_oc=Adr0ZXLJg--_9LY1GPBvQABFqOzL6wTn_aMOdCu9Zr2BLpmWroH4DZsu0X8vbozAD3E&_nc_zt=24&_nc_ht=scontent-lga3-3.xx&_nc_gid=WDxpm-eBdx7_ruGu2J3r9g&_nc_ss=7e289&oh=00_Af56igLhRkYx3GHjB0h01m3pF--mGdMzoxFg0euvJmK5DA&oe=69FEB26B"}],"host_names":["The Indie Flea"],"creator":{"id":"100082008263628","name":"The Indie Flea","type":"User","url":null,"is_verified":null,"profile_picture_url":null},"description_links":[],"can_viewer_message":false},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/adLibrary/ad":{"post":{"operationId":"social_facebook_ad_library_ad","x-nexscope-slug":"social-facebook-ad-library-ad","summary":"Facebook Ad Library Ad Details","description":"Retrieves detailed information about a specific Facebook ad by its ID or URL. Returns adArchiveID, pageName, isActive, startDate, endDate, and a snapshot containing body, images, videos, display_format, link_url, and cta_text. Regulated ads may also include source-dependent aaa_info using the structure shown below. Political and social issue delivery data is normalized to location_audience and age_country_gender_reach_breakdown. Political location_audience rows include reach, and political delivery values are fractional shares, so 0.08 means 8%. Regional transparency data may use absolute reach counts. For ads with multiple versions, the ad creative is found in the snapshot.cards array rather than snapshot.body. Transcription is opt-in via get_transcript=true. Default short AI (up to 120 seconds, inclusive) is included in the existing base endpoint price, with no extra AI fee. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. On detail routes, successful paid-mode AI costs are in addition to the existing base endpoint cost; media-download pricing is unchanged. Returned native captions leave the base endpoint price unchanged. Empty AI results and errors incur no AI fee; the base scrape fee still applies when the detail scrape succeeds. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Ad Library Ad Details API View Pricing Get Facebook Ad Library details by ID or URL. For ads with multiple versions, use the title in cards. 1 credit per request\nRetrieves detailed information about a specific Facebook ad by its ID or URL. Returns adArchiveID, pageName, isActive, startDate, endDate, and a snapshot containing body, images, videos, display_format, link_url, and cta_text. Regulated ads may also include source-dependent aaa_info using the structure shown below. Political and social issue delivery data is normalized to location_audience and age_country_gender_reach_breakdown. Political location_audience rows include reach, and political delivery values are fractional shares, so 0.08 means 8%. Regional transparency data may use absolute reach counts. For ads with multiple versions, the ad creative is found in the snapshot.cards array rather than snapshot.body. Transcription is opt-in via get_transcript=true. Default short AI (up to 120 seconds, inclusive) is included in the existing base endpoint price, with no extra AI fee. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. On detail routes, successful paid-mode AI costs are in addition to the existing base endpoint cost; media-download pricing is unchanged. Returned native captions leave the base endpoint price unchanged. Empty AI results and errors incur no AI fee; the base scrape fee still applies when the detail scrape succeeds. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nPaid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nTranscription is opt-in via get_transcript=true. Default short AI (up to 120 seconds, inclusive) is included in the existing base endpoint price, with no extra AI fee. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. On detail routes, successful paid-mode AI costs are in addition to the existing base endpoint cost; media-download pricing is unchanged. Returned native captions leave the base endpoint price unchanged. Empty AI results and errors incur no AI fee; the base scrape fee still applies when the detail scrape succeeds. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit; default short AI is included; allow_long_transcription=true adds 10 credits per started minute to the existing base cost). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Facebook Ad Id"},"url":{"type":"string","description":"Facebook Ad URL"},"allow_long_transcription":{"type":"boolean","default":false,"description":"Paid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed."},"get_transcript":{"type":"boolean","description":"Transcription is opt-in via get_transcript=true. Default short AI (up to 120 seconds, inclusive) is included in the existing base endpoint price, with no extra AI fee. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. On detail routes, successful paid-mode AI costs are in addition to the existing base endpoint cost; media-download pricing is unchanged. Returned native captions leave the base endpoint price unchanged. Empty AI results and errors incur no AI fee; the base scrape fee still applies when the detail scrape succeeds. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed."},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit; default short AI is included; allow_long_transcription=true adds 10 credits per started minute to the existing base cost). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":[],"additionalProperties":false},"example":{"url":"https://www.facebook.com/ads/library?id=1977941946171006"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook-ad-library","data":{"success":true,"adArchiveID":1185617869915074,"endDate":1750316400,"isAAAEligible":false,"isActive":true,"pageID":15087023444,"pageName":"Nike","politicalCountries":[],"reachEstimate":null,"snapshot":{"ad_creative_id":1809449763118705,"cards":[],"body_translations":{},"byline":null,"caption":"fb.com","cta_text":"Learn more","dynamic_item_flags":{},"dynamic_versions":null,"edited_snapshots":[],"event":[],"extra_images":[{"original_image_handle":"https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/508997149_744746594672572_3057533797808431470_n.jpg?_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=eKgqs7-b06UQ7kNvwGSYm41&_nc_oc=AdnV_v1Anh3aqBBXDa3xwDrMtLJUCvE8yKIgP5ODbX3xsSMCtTv2ucMTy36I8Bq20HU&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=ocFZ2kPWmNZ0nKyk5HCtkQ&oh=00_AfNfDJHp6d0Ie9tIXLBIXFQiMgWHVl1i48DahYYOgANgHg&oe=685A4B4A","resized_image_handle":"https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/508997149_744746594672572_3057533797808431470_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=eKgqs7-b06UQ7kNvwGSYm41&_nc_oc=AdnV_v1Anh3aqBBXDa3xwDrMtLJUCvE8yKIgP5ODbX3xsSMCtTv2ucMTy36I8Bq20HU&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=ocFZ2kPWmNZ0nKyk5HCtkQ&oh=00_AfMe107fPkaznD6Pw8_wDaon3p-31ZXLHIeglHU_P3NYNw&oe=685A4B4A"}],"extra_links":["https://www.nike.com.ar/"],"extra_texts":[],"extra_videos":[],"instagram_shopping_products":[],"display_format":"image","title":"6 cuotas sin interés","link_description":null,"link_url":"https://fb.com/canvas_doc/1952657995267951","page_welcome_message":null,"images":[{"original_image_url":"https://scontent-ord5-2.xx.fbcdn.net/v/t39.35426-6/499542231_3815578848587795_5060085138610262269_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=yk26_frcPLkQ7kNvwF5EWnq&_nc_oc=Adk8Xjt1SjUg-mBxkm6iUuDfXpyGXD5G5g6PBae8g0WWsJT-MfnhNGII7JL-KM5MJBE&_nc_zt=14&_nc_ht=scontent-ord5-2.xx&_nc_gid=ocFZ2kPWmNZ0nKyk5HCtkQ&oh=00_AfP6zfVuLkcD2Zts0gItXp801QK1k0lhEfqwwdqfNAU9gw&oe=685A3E80","resized_image_url":"https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/509090139_3448752085259208_8196922920009954562_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=tV3v2Y_NIh0Q7kNvwEMM-Vk&_nc_oc=AdnpccGMqNlM0k9O87VmMBIp9pGtj3l1dkO5HaKRCti2V4X6AKUn8BR08SXOc_Y-8TY&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=ocFZ2kPWmNZ0nKyk5HCtkQ&oh=00_AfPXGzKezcPJSpAq8Ql2Xgx6Rn0a3Poit-iTirfhAwuiHA&oe=685A5634","watermarked_resized_image_url":"","image_crops":{}}],"videos":[],"creation_time":1750344986,"page_id":15087023444,"page_name":"Nike","page_profile_picture_url":"https://scontent-ord5-2.xx.fbcdn.net/v/t39.35426-6/508670148_9776464209142246_4487234065380829819_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Q0UJas7Kz2wQ7kNvwGKBRCa&_nc_oc=AdnobFr6ScYQJzp_Za4UEgMY34n373z6WuZwOA3h-ixlpbii4wA8lxcgAsbtBpCE3t4&_nc_zt=14&_nc_ht=scontent-ord5-2.xx&_nc_gid=ocFZ2kPWmNZ0nKyk5HCtkQ&oh=00_AfMlwCCMXN-4KPAZac9pYLWrHGZpld9SoTX1r9S9xRHB8Q&oe=685A5861","page_categories":{"1713352298924731":"Sportswear"},"page_entity_type":"person_profile","page_is_profile_page":false,"instagram_actor_name":"Nike","instagram_profile_pic_url":"https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/499229861_3519049748228633_8442052921006945421_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=eJcuzztd8e4Q7kNvwEpFLbr&_nc_oc=AdlI7WAi5QRhAOZCLwHcU3ZgxpxWSTzJr9PjPiwtUN9U2mkMB49Surq8HsQcDWfnTVc&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=ocFZ2kPWmNZ0nKyk5HCtkQ&oh=00_AfNnIjlMGopiAeVY7yEOxCT0sEvrij87SMrpkGJHs1lT-w&oe=685A55E2","instagram_url":"","instagram_handle":"","is_reshared":false,"version":3},"totalActiveTime":23488,"spend":null,"startDate":1750316400,"publisherPlatform":["facebook"],"url":"https://www.facebook.com/ads/library?id=1185617869915074","startDateString":"2025-06-19T07:00:00.000Z","endDateString":"2025-06-19T07:00:00.000Z","aaa_info":null},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/adLibrary/ad/transcript":{"post":{"operationId":"social_facebook_ad_library_ad_transcript","x-nexscope-slug":"social-facebook-ad-library-ad-transcript","summary":"Facebook Ad Library Ad Transcript","description":"Retrieves a transcript for a Facebook Ad Library video ad by ID or URL. Returned native captions cost 1 credit. Otherwise the public video URL is transcribed with AI. If the ad has no video or no transcript is available, transcript is null and the charge is 0 credits. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Ad Library Ad Transcript API View Pricing Get native captions or an AI transcript from a Facebook video ad. Long AI transcripts may time out. Native captions or AI up to 2 minutes: 1 credit. Paid AI mode: 10 credits/minute, rounded up, even for short videos. No transcript: 0 credits.\nRetrieves a transcript for a Facebook Ad Library video ad by ID or URL. Returned native captions cost 1 credit. Otherwise the public video URL is transcribed with AI. If the ad has no video or no transcript is available, transcript is null and the charge is 0 credits. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nPaid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (Returned native captions cost 1 credit, even for long videos with the paid flag. By default, successful AI up to 120 seconds costs a flat 1 credit per request; over 120 seconds requires allow_long_transcription=true, which bills ALL successful AI at 10 credits per started minute, including short videos; empty AI results and errors cost 0 credits; no transcript: 0 credits). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Facebook Ad Id"},"url":{"type":"string","description":"Facebook Ad URL"},"allow_long_transcription":{"type":"boolean","default":false,"description":"Paid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed."},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (Returned native captions cost 1 credit, even for long videos with the paid flag. By default, successful AI up to 120 seconds costs a flat 1 credit per request; over 120 seconds requires allow_long_transcription=true, which bills ALL successful AI at 10 credits per started minute, including short videos; empty AI results and errors cost 0 credits; no transcript: 0 credits). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":[],"additionalProperties":false},"example":{"url":"https://www.facebook.com/ads/library?id=1977941946171006","allow_long_transcription":false}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook-ad-library","data":{"success":true,"data":{"ad_id":"1020359190509080","url":"https://www.facebook.com/ads/library?id=1020359190509080","transcript":"Sample transcript text from the ad video...","transcript_available":true}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/adLibrary/search/ads":{"post":{"operationId":"social_facebook_ad_library_search_ads","x-nexscope-slug":"social-facebook-ad-library-search-ads","summary":"Facebook Ad Library Search","description":"Searches the Meta Ad Library by keyword and returns matching ads. Supports filtering by language with a 2-letter code such as EN or ES. Each result includes ad_archive_id, page_name, is_active, publisher_platform, and a snapshot with body text, images, videos, and cta_text. Both GET and POST are supported. Use GET for normal requests. If the cursor becomes too large after extensive pagination, use POST and send the same parameters in the JSON body. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Ad Library Search API View Pricing Search Meta Ad Library by keyword. Use GET normally; for long pagination cursors, use POST with the same parameters in the JSON body. 1 credit per request GET /v1/facebook/adLibrary/search/ads\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Keyword to search for"},"sort_by":{"type":"string","enum":["total_impressions","relevancy_monthly_grouped"],"description":"Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions."},"search_type":{"type":"string","enum":["keyword_unordered","keyword_exact_phrase"],"description":"If you want to search by exact phrase or not"},"ad_type":{"type":"string","enum":["all","political_and_issue_ads"],"description":"Search for all ads or only political and issue ads"},"country":{"type":"string","description":"This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL."},"language":{"type":"string","description":"Language to filter ads on. Needs to be a 2 letter language code, such as EN, ES, or FR."},"status":{"type":"string","enum":["ALL","ACTIVE","INACTIVE"],"description":"Status of the ad. Defaults to ACTIVE."},"media_type":{"type":"string","enum":["ALL","IMAGE","VIDEO","MEME","IMAGE_AND_MEME","NONE"],"description":"Media type of the ad. Defaults to ALL. Meme just means the ad has text and an image. No clue why they call it meme."},"start_date":{"type":"string","description":"Impressions start date. Needs to be in YYYY-MM-DD format."},"end_date":{"type":"string","description":"Impressions end date. Needs to be in YYYY-MM-DD format."},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"},"cursor":{"type":"string","description":"Cursor to paginate through results"}},"required":["query"],"additionalProperties":false},"example":{"query":"running"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook-ad-library","data":{"success":true,"searchResults":[{"ad_archive_id":"1378176106734781","end_date":1747638000,"is_aaa_eligible":false,"is_active":true,"page_id":"119749581219299","page_name":"Makhumalo","political_countries":[],"reach_estimate":null,"snapshot":{"branded_content":null,"page_id":"119749581219299","page_is_deleted":false,"page_profile_uri":"https://www.facebook.com/61550737114480/","root_reshared_post":null,"byline":null,"disclaimer_label":null,"page_name":"Makhumalo","page_profile_picture_url":"https://scontent-sjc3-1.xx.fbcdn.net/v/t39.35426-6/499107970_2293645317822147_4932735414928456888_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=DBNo3Z6ft4AQ7kNvwESjMWN&_nc_oc=AdnZGvglABgVlSJ6UIGIbWgFeUL2LnoBSuMbBvti20zRjb_UUDRzhGxAZ0ip3ye1EQI&_nc_zt=14&_nc_ht=scontent-sjc3-1.xx&_nc_gid=49D7P4N6a4mVqUW8WdOxag&oh=00_AfMEXcKVf3KYJpFehTTToe8MXUZslTHE9P-xS2eyVCeGKA&oe=685A4903","body":{"text":"This is my second pair. I only take them off to go to sleep. I put them on first thing in the morning. I am 59 and have neuropathy in my feet, they bring me comfort every day.” -Lydia P.\uD83D\uDC4D\uD83D\uDC4D\uD83D\uDC4D\n❤️These orthopedic shoes provide great comfort and ease foot and knee pain! \uD83D\uDE0D\n✅ Ideal for wide feet \n✅ comfortable \n✅ they are ideal for everyday life.\nGet Yours Now : https://www.ghemshop.com/products/buckled-square"},"is_reshared":false,"brazil_tax_id":null,"caption":"ghemshop.com","cards":[],"cta_text":"Shop now","cta_type":"SHOP_NOW","country_iso_code":null,"current_page_name":"Makhumalo","display_format":"IMAGE","event":null,"images":[{"original_image_url":"https://scontent-sjc3-1.xx.fbcdn.net/v/t39.35426-6/499507599_4016645891948767_4341363175504946673_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=3EJ6TbZR3GEQ7kNvwErfuF4&_nc_oc=AdkQPpJ9OYN_J3P5xTetGSb9FDCFZzfoLSj59Bbp6s-g5HGg-zTECrgOm8mjkJfk5JE&_nc_zt=14&_nc_ht=scontent-sjc3-1.xx&_nc_gid=49D7P4N6a4mVqUW8WdOxag&oh=00_AfMTuIozb2-VJgGP7NCIx0pG91b48CzMgm_1eT7STgBvew&oe=685A6906","resized_image_url":"https://scontent-sjc3-1.xx.fbcdn.net/v/t39.35426-6/499504336_1222720305887055_488411876974522066_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=DYkDYH-EJrQQ7kNvwF-b_ov&_nc_oc=Adn2l2fDwHaN4h6W-OxxgoYkb0IUAeCpYH5bociuO_oxVL9L0wLg5vqnNfJa0ehQwqY&_nc_zt=14&_nc_ht=scontent-sjc3-1.xx&_nc_gid=49D7P4N6a4mVqUW8WdOxag&oh=00_AfNkQcMpUNFcM7tF1M5tAHmVwABzLx5QKUU8CFo69NP3Rg&oe=685A4518","watermarked_resized_image_url":"","image_crops":[]}],"link_description":"\uD83D\uDD25Best Seller-Last Day Sale 60% OFF\uD83D\uDD25 Buckled Square Heel Sandals for Women","link_url":"https://www.ghemshop.com/products/buckled-square","page_categories":["Musician"],"page_entity_type":"PERSON_PROFILE","page_is_profile_page":false,"page_like_count":7,"title":"\uD83D\uDD25Best Seller-Last Day Sale 60% OFF\uD83D\uDD25 Buckled Square Heel Sandals for Women","videos":[],"additional_info":null,"ec_certificates":[],"extra_images":[],"extra_links":[],"extra_texts":[],"extra_videos":[]},"total_active_time":null,"spend":null,"start_date":1747638000,"publisher_platform":["FACEBOOK"],"url":"https://www.facebook.com/ads/library?id=1378176106734781","start_date_string":"2025-05-19T07:00:00.000Z","end_date_string":"2025-05-19T07:00:00.000Z"}],"searchResultsCount":50001,"cursor":"AQHRLKHyzb3ZNTn1O3qr6lG7ncS9gfboI0HWGSDETVUnipTSXVY8E4Wb-568JBicOvYS"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/adLibrary/company/ads":{"post":{"operationId":"social_facebook_ad_library_company_ads","x-nexscope-slug":"social-facebook-ad-library-company-ads","summary":"Facebook Ad Library Company Ads","description":"Fetches all ads currently running for a specific company from the Meta Ad Library. Each ad includes ad_archive_id, page_name, is_active, publisher_platform, and a snapshot with body, images, videos, and display_format. Supports filtering by country, media_type, date range, and language with cursor-based pagination. Both GET and POST are supported. If the cursor becomes too large after extensive pagination, use POST and send the same parameters in the JSON body. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Ad Library Company Ads API View Pricing Get a company's running ads. Use GET normally; for long pagination cursors, use POST with the same parameters in the JSON body. 1 credit per request GET /v1/facebook/adLibrary/company/ads\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"pageId":{"type":"string","description":"The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName"},"companyName":{"type":"string","description":"The name of the company. Can either use this or pageId"},"country":{"type":"string","description":"This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL."},"status":{"type":"string","enum":["ALL","ACTIVE","INACTIVE"],"description":"Status of the ad. Defaults to ACTIVE."},"media_type":{"type":"string","enum":["ALL","IMAGE","VIDEO","MEME","IMAGE_AND_MEME","NONE"],"description":"Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme."},"language":{"type":"string","description":"Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc"},"sort_by":{"type":"string","enum":["total_impressions","relevancy_monthly_grouped"],"description":"Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions."},"start_date":{"type":"string","description":"Start date to search for. Format: YYYY-MM-DD"},"end_date":{"type":"string","description":"End date to search for. Format: YYYY-MM-DD"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"},"cursor":{"type":"string","description":"Cursor to paginate through results"}},"required":[],"additionalProperties":false,"anyOf":[{"required":["pageId"]},{"required":["companyName"]}]},"example":{"companyName":"Nike"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook-ad-library","data":{"success":true,"results":[{"ad_archive_id":"1212560900568826","end_date":1750230000,"is_aaa_eligible":false,"is_active":true,"page_id":"15087023444","page_name":"Nike","political_countries":[],"reach_estimate":null,"snapshot":{"body":{"text":"Que el frío no te detenga. Explora la colección de invierno con estilo y actitud Nike. \uD83E\uDDE5"},"branded_content":null,"brazil_tax_id":null,"byline":null,"caption":"fb.com","cards":[],"cta_text":"Learn more","cta_type":"LEARN_MORE","country_iso_code":null,"current_page_name":"Nike","disclaimer_label":null,"display_format":"VIDEO","event":null,"images":[],"is_reshared":false,"link_description":null,"link_url":"https://fb.com/canvas_doc/569658969305127","page_categories":["Ropa deportiva"],"page_entity_type":"PERSON_PROFILE","page_id":"15087023444","page_is_deleted":false,"page_is_profile_page":false,"page_like_count":37497718,"page_name":"Nike","page_profile_picture_url":"https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/508742493_1906025190144374_200543536673957484_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=GUPolKbhQA4Q7kNvwH8Woql&_nc_oc=AdnsaYY9-9p8kkFm594f86VsMEc2Wias8yMQ69ZC2VOv642bjUgMRJNtfihFM4vr62o&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=mmzWe0H6RNHM_tNirxejrQ&oh=00_AfO73iYbuEFgc4yfmi6pUnjLAd0I1W5ac9hmHZqjq2KP3g&oe=685A4C47","page_profile_uri":"https://facebook.com/nike","root_reshared_post":null,"title":"Look de invierno activado","videos":[{"video_hd_url":"https://video-ord5-2.xx.fbcdn.net/v/t42.1790-2/508345466_4710910465802253_4502560017294477681_n.?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=_z9ndrNSqU4Q7kNvwErNTOY&_nc_oc=AdlSb3GVLWTjl3iI6uvIsrEya2ZR-1ex8t8yXOr3e9u13u3xboXylCxrkWzfLsvDQcU&_nc_zt=28&_nc_ht=video-ord5-2.xx&_nc_gid=mmzWe0H6RNHM_tNirxejrQ&oh=00_AfNNOrS6GBT-R_RV15FpphRv-mUwyGoqJClQpP-LCOcqfQ&oe=685A6586","video_preview_image_url":"https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/508472131_2706791729511119_7655112167724018421_n.jpg?_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=-GGzon31Wl4Q7kNvwHpWdG2&_nc_oc=AdnRHcWzvX05mBu9KrhDjKgOuCYLKjNg_hm8eKY2dNaFg-4tpYznNPJvbLl7CAnB-2A&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=mmzWe0H6RNHM_tNirxejrQ&oh=00_AfMijP4k74e949uFas1PkfzzwiYWH_G49J4W-EYJa31VEQ&oe=685A3DDC","video_sd_url":"https://video-ord5-3.xx.fbcdn.net/v/t42.1790-2/503830433_1272051757688626_4613408767025280545_n.mp4?_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=zKD6ziOmKVgQ7kNvwFGCx5N&_nc_oc=AdkdTw235NDuAczGAvCTLl5TnQ8rUcWjy1QBEj8CC4Id8hVQPMexxPtU3froQOYk1OE&_nc_zt=28&_nc_ht=video-ord5-3.xx&_nc_gid=mmzWe0H6RNHM_tNirxejrQ&oh=00_AfNqJDVyyTMYnf7xs5te87vB3A0v3IGy41tdxT1ZvrAAlQ&oe=685A4FC3","watermarked_video_hd_url":"","watermarked_video_sd_url":""}],"additional_info":null,"ec_certificates":[],"extra_images":[],"extra_links":["https://www.nike.com.pe/productos/ropa/casacas-y-chalecos_conjunto_pantalones_poleras?utm_source=facebook&utm_medium=paid&utm_campaign=junio_invierno_transacciones&utm_content=intereses2_invierno_collection2"],"extra_texts":[],"extra_videos":[{"video_hd_handle":"https://video-ord5-3.xx.fbcdn.net/v/t42.1790-2/508262243_4710910432468923_4352661581573318069_n.?_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=bQXAtOCS-PMQ7kNvwEbVbC_&_nc_oc=AdnZ87pJ-oeIb5L7fizjaxNmRp0qkvq2SP_ADcnPFzMPca1L8gvUkpmF_c5vrAYmetw&_nc_zt=28&_nc_ht=video-ord5-3.xx&_nc_gid=mmzWe0H6RNHM_tNirxejrQ&oh=00_AfM8Q_xyap9vnoEn5T7FqI9yfO1ySPPKyJVGXPmaim5tCw&oe=685A58CD","video_sd_handle":"https://video-ord5-3.xx.fbcdn.net/v/t42.1790-2/503830433_1272051757688626_4613408767025280545_n.mp4?_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=zKD6ziOmKVgQ7kNvwFGCx5N&_nc_oc=AdkdTw235NDuAczGAvCTLl5TnQ8rUcWjy1QBEj8CC4Id8hVQPMexxPtU3froQOYk1OE&_nc_zt=28&_nc_ht=video-ord5-3.xx&_nc_gid=mmzWe0H6RNHM_tNirxejrQ&oh=00_AfNqJDVyyTMYnf7xs5te87vB3A0v3IGy41tdxT1ZvrAAlQ&oe=685A4FC3","watermarked_video_hd_url":null,"watermarked_video_sd_url":null}]},"total_active_time":null,"spend":null,"start_date":1750143600,"publisher_platform":["FACEBOOK"],"url":"https://www.facebook.com/ads/library?id=1212560900568826","start_date_string":"2025-06-17T07:00:00.000Z","end_date_string":"2025-06-18T07:00:00.000Z"}],"cursor":"AQHR2LpCDWOZyAGp-ZKr8rUsapAXh8rWjYuNxVvuU7L0kte18hxkxnaXM3e5jEZNgdcU"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/facebook/adLibrary/search/companies":{"post":{"operationId":"social_facebook_ad_library_search_companies","x-nexscope-slug":"social-facebook-ad-library-search-companies","summary":"Facebook Ad Library Search for Companies","description":"Searches for companies by name in the Meta Ad Library and returns their page IDs for use with other ad library endpoints. Each result includes page_id, name, category, likes, verification status, and Instagram details like ig_username and ig_followers. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Facebook Ad Library Search for Companies API View Pricing Search for companies by name and get their ad library page id 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Keyword to search for"}},"required":["query"],"additionalProperties":false},"example":{"query":"nike"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"facebook-ad-library","data":{"success":true,"searchResults":[{"page_id":"51212153078","category":"Product/service","image_uri":"https://scontent.ford4-1.fna.fbcdn.net/v/t39.30808-1/387181570_863325755161415_3589774989337788111_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=103&ccb=1-7&_nc_sid=418b77&_nc_ohc=SzL6LoxpjrMQ7kNvgF5Uyy3&_nc_oc=AdgIflwSC-gA-77yFJHPKOC1dEGUI7YqvKYkmll9n5n8BcvLzRKToufpLG-068BnjE4&_nc_zt=24&_nc_ht=scontent.ford4-1.fna&_nc_gid=AYuU655BQ_HFcmz-fz9agWZ&oh=00_AYDD0ELO2MQikn7TBtxiTe7n64HX6iKiI5ofiI86BQ_jYw&oe=67CAC605","likes":41136495,"verification":"BLUE_VERIFIED","name":"Nike Football","country":null,"entity_type":"PERSON_PROFILE","ig_username":"nikefootball","ig_followers":46451228,"ig_verification":true,"page_alias":"nikefootball","page_is_deleted":false}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/ad-library/search":{"post":{"operationId":"social_tiktok_ad_library_search","x-nexscope-slug":"social-tiktok-ad-library-search","summary":"TikTok Ad Library Ad Library Search","description":"Searches TikTok's public Ads Library using either query for a general search or advertiser_name for advertiser-specific results. Advertiser-name searches resolve the name through TikTok's advertiser typeahead first, then search the selected advertiser entity and return adv_biz_ids on each ad. You can pass adv_biz_ids with advertiser_name to pin the exact advertiser shown in TikTok's See all ads link. TikTok requires the name with the ID and ignores an ID-only search, so provide exactly one of query or advertiser_name. If TikTok has no matching advertiser entity, the API falls back to TikTok's name search. Results are global, sorted by the latest shown date, support cursor pagination, and include a public TikTok Ads Library URL for each ad. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Ad Library Ad Library Search API View Pricing Search TikTok's public Ads Library by general query or advertiser name. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"General ad search. Provide either query or advertiser_name, not both."},"advertiser_name":{"type":"string","description":"Advertiser name to resolve through TikTok's typeahead and search by advertiser entity. Falls back to TikTok's name search when no entity matches. Provide either advertiser_name or query, not both."},"adv_biz_ids":{"type":"string","description":"TikTok advertiser business ID from a See all ads link. Use it with advertiser_name to pin the exact advertiser. Required companion: advertiser_name; ID-only searches return 400 because TikTok ignores the ID without the name."},"cursor":{"type":"string","description":"Opaque cursor returned from the previous response."}},"required":[],"additionalProperties":false},"example":{"query":"The Creator Loop"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok-ad-library","data":{"success":true,"source":"tiktok_public_ads_library","advertiser_name":"Gymshark","resolved_advertiser_name":"GYMSHARK LTD","advertiser_matches":[{"name":"GYMSHARK LTD","ids":"7078923208527618049"}],"ads":[{"id":"1871655924410641","url":"https://library.tiktok.com/ads/detail/?ad_id=1871655924410641","name":"GYMSHARK LTD","adv_biz_ids":"7078923208527618049","audit_status":"1","type":"2","first_shown_date":1784937600000,"last_shown_date":1785024000000,"videos":[{"video_url":"https://library.tiktok.com/api/v1/cdn/...","cover_img":"https://p16-common-sign.tiktokcdn.com/..."}],"estimated_audience":"1K-10K","spent":"","impression":0,"show_mode":1,"image_urls":[],"rejection_info":null,"sor_audit_status":"1"}],"total":62344,"has_more":true,"cursor":"opaque cursor for the next page"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/tiktok/ad-library/ad":{"post":{"operationId":"social_tiktok_ad_library_ad","x-nexscope-slug":"social-tiktok-ad-library-ad","summary":"TikTok Ad Library Ad Library Ad","description":"Fetches one TikTok ad by ID or URL. It first checks Creative Center Top Ads (ads.tiktok.com), then TikTok's public transparency Ads Library (library.tiktok.com) when the ID is not a Top Ads material. Both sources return the same response shape. Fields TikTok does not expose for a public Ads Library ad are null, empty, or false as appropriate. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. TikTok Ad Library Ad Library Ad API View Pricing Gets details for a TikTok ad from either Creative Center Top Ads or TikTok's public Ads Library. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ad_id":{"type":"string","description":"Creative Center Top Ads material ID or URL, or a public Ads Library ad ID or library.tiktok.com detail URL."}},"required":["ad_id"],"additionalProperties":false},"example":{"ad_id":"1869335220395266"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"tiktok-ad-library","data":{"success":true,"ad_title":"I thought this was a gimmick until I tried it! A wrinkled shirt, one button, and a few minutes later... ready to wear. Tap the link in bio and see why everyone’s talking about Bellairon before it sells out. @Bellairon LLC ","brand_name":"","comment":1,"cost":1,"country_code":["TR"],"ctr":0.5,"favorite":false,"has_summary":false,"highlight_text":"","id":"7646829987799334920","industry_key":"label_22108000000","is_search":false,"keyword_list":null,"landing_page":"https://www.amazon.com/dp/B0DRTC8XBW?ref=cm_sw_r_cso_wa_apin_dp_71W8F02XC4M4QZRQ5RQN&ref_=cm_sw_r_cso_wa_apin_dp_71W8F02XC4M4QZRQ5RQN&social_share=cm_sw_r_cso_wa_apin_dp_71W8F02XC4M4QZRQ5RQN&oas=true&utm_source=tiktok&utm_medium=paid&utm_id=__CAMPAIGN_ID__&utm_campaign=__CAMPAIGN_NAME__","like":92,"objective_key":"campaign_objective_reach","objectives":[{"label":"campaign_objective_reach","value":5}],"pattern_label":[],"share":1,"source":"Others","source_key":73,"video_info":{"vid":"v12044gd0000d8erq07og65h1cq991gg","duration":89.767,"cover":"https://p16-common-sign.tiktokcdn.com/tos-maliva-p-0068c799-us/oIbqBdvfEAiFpgvAOgrQHCF5R0mkDDLiEfvQDS~tplv-noop.image?dr=18692&refresh_token=2cdb79e2&x-expires=1781231880&x-signature=W%2BBTq1VGRRaNnIuMGUpWWSgmOoo%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v12044gd0000d8erq07og65h1cq991gg","video_url":{"540p":"https://v16m-default.tiktokcdn.com/3e7ec770348dbc627fc02ea1e8417c25/6a2b7108/video/tos/maliva/tos-maliva-ve-0068c799-us/oIN2GPIRgHAUBHOeNfLk2HBSERoJeIALGC3jAE/?a=0&bti=NTU4QDM1NGA%3D&&bt=315&ft=cApXJCz7ThWHKnz9LGZmo0P&mime_type=video_mp4&rc=Omk6ZWQ7Nzc7OGY8PGVnOkBpajQ8Zms5cjN1OzMzZzczNEBgNDAzXl9hXjMxLzEvXjFiYSNkNm4uMmQ0bmJhLS1kMS9zcw%3D%3D&vvpl=1&l=20260612043631BE40574FD5FFAA863321&btag=e00090000","720p":"https://v16m-default.tiktokcdn.com/9f16ea869602069b9fdad27dc113cb48/6a2b7108/video/tos/maliva/tos-maliva-ve-0068c799-us/ooEipQa9HbhJ4ChzASIngUPhBAdXiABIvxU2E/?a=0&bti=NTU4QDM1NGA%3D&&bt=877&ft=cApXJCz7ThWHKnz9LGZmo0P&mime_type=video_mp4&rc=ZTg3OTQ0NTQzZGVpNWg6NkBpajQ8Zms5cjN1OzMzZzczNEBhNC0yMDViNi8xLV9hX2AuYSNkNm4uMmQ0bmJhLS1kMS9zcw%3D%3D&vvpl=1&l=20260612043631BE40574FD5FFAA863321&btag=e00090000"},"width":720,"height":1280},"voice_over":false,"creative_center_url":"https://ads.tiktok.com/business/creativecenter/topads/7646829987799334920/pc/en","detail_analysis":null,"interactive_time_analysis":{"ctr":{"metric":"retain_ctr","analysis":[{"second":0,"value":0.048321828136158054}],"duration":91,"highlight":[1],"percentile":0.99},"cvr":{"metric":"retain_cvr","analysis":[{"second":0,"value":0}],"duration":91,"highlight":[],"percentile":0.99},"clicks":{"metric":"click_cnt","analysis":[{"second":0,"value":0.2631578947368421}],"duration":91,"highlight":[1],"percentile":0.99},"conversion":{"metric":"convert_cnt","analysis":[{"second":0,"value":0}],"duration":91,"highlight":[],"percentile":0.99},"remain":{"metric":"play_retain_cnt","analysis":[{"second":0,"value":1}],"duration":91,"highlight":[],"percentile":0.99}},"recommended_for_you":[{"ad_title":"Adımlarınıza eğlence katmaya hazır mısınız? \"Hiç böyle çorap görmüş müydünüz?\" diyoruz ve iddiamızı ortaya koyuyoruz! ​Giyimkent Outlet İndirim Çadırı'nda çorap modasına yepyeni bir boyut getirdik. Sevdiğiniz popüler kültür ve kült anime karakterlerini, kolları hareket edebilen bu özel 3 boyutlu tasarım çoraplarla tarzınıza taşıyın.  İster günlük kombinlerinize eğlenceli bir dokunuş yapın, ister arkadaşlarınıza tebessüm ettirecek harika bir hediye seçin. Videomuzdaki gibi ister halay çektirin, ister horon teptirin; seçim sizin! ​Bu benzersiz ve eğlenceli tasarım çoraplarda dev fırsat: 2 Adet Sadece 100 TL! Favori karakterleriniz tükenmeden sizleri de Esenler'deki Giyimkent Outlet indirim çadırımıza bekliyoruz. Adresimiz: Oruçreis mah. Giyimkent Caddesi No:5 Esenler/İstanbul M7 Metro Hattı Giyimkent durağı önü. Hafta içi 10:00 ile 19:00 Hafta Sonu 10:00 - 20:00 Saatleri Arasında açıktır. #alışverişfestivali #kampanya #outlet #giyimkent ","brand_name":"","cost":0,"ctr":0.63,"favorite":false,"id":"7644102379697602567","industry_key":"label_22108000000","is_search":false,"like":127,"objective_key":"campaign_objective_reach","video_info":{"vid":"v1c044g50000d86qrfnog65v7nuvf30g","duration":13.213,"cover":"https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/ogCtJD4GUCr8GavLIfI1jAQ9IDvNeGEAfjQgg9~tplv-noop.image?dr=18692&refresh_token=fc9b28a3&x-expires=1781231805&x-signature=zYq%2F3BQnXoM8CMFBFKDON6lhPBs%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v1c044g50000d86qrfnog65v7nuvf30g","video_url":{"720p":"https://v16m-default.tiktokcdn.com/1342656e028b133716a1e892a89e214a/6a2b70bd/video/tos/alisg/tos-alisg-pve-0037c001/os3NtUfeIHH1ALjc3Q4IWADrx9BGCBG8IEgejj/?a=0&bti=NTU4QDM1NGA%3D&&bt=837&ft=cApXJCz7ThWHanz9LGZmo0P&mime_type=video_mp4&rc=ZDY4NTppZjg4ZWY6Nzc2NEBpajZ5cXk5cml0OzMzODczNEAwYi41YWMwNWMxYGEyM2IyYSMtY3I0MmRrbzNhLS1kMWBzcw%3D%3D&vvpl=1&l=20260612043632D3452D043274878B2384&btag=e000b0000"},"width":576,"height":1024}}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/google/company/ads":{"post":{"operationId":"social_google_company_ads","x-nexscope-slug":"social-google-company-ads","summary":"Google Ad Library Company Ads","description":"Fetches public company ads by domain or advertiser_id. The default list includes IDs, previews, and firstShown/lastShown when available, at 1 credit per request. firstShown can be null in /v1/google/ad for the same ad, so keep the list date rather than overwriting it with a null detail date. Setting get_ad_details=true uses the individual-ad source, which can also omit firstShown, and costs 25 credits per request. Login-only ads are unavailable. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Google Ad Library Company Ads API View Pricing Get public company ads with dates when available (1 credit). Set get_ad_details=true for full details (25 credits). firstShown can be null in detail responses even when the default list has it. 1 credit per request\nFetches public company ads by domain or advertiser_id. The default list includes IDs, previews, and firstShown/lastShown when available, at 1 credit per request. firstShown can be null in /v1/google/ad for the same ad, so keep the list date rather than overwriting it with a null detail date. Setting get_ad_details=true uses the individual-ad source, which can also omit firstShown, and costs 25 credits per request. Login-only ads are unavailable.\nSet to true to get the ad details. Will cost 25 credits.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","description":"The domain of the company"},"advertiser_id":{"type":"string","description":"The advertiser id of the company"},"topic":{"type":"string","enum":["all","political"],"description":"The topic to search for. If you search for 'political', you will also need to pass a 'region', like 'US' or 'AU'"},"region":{"type":"string","description":"The region to search for. Defaults to anywhere"},"start_date":{"type":"string","description":"Start date to search for. Format: YYYY-MM-DD"},"end_date":{"type":"string","description":"End date to search for. Format: YYYY-MM-DD"},"platform":{"type":"string","enum":["google_maps","google_play","google_search","google_shopping","youtube"],"description":"Platform to search for."},"format":{"type":"string","enum":["text","image","video"],"description":"Ad format to search for."},"get_ad_details":{"type":"string","description":"Set to true to get the ad details. Will cost 25 credits."},"cursor":{"type":"string","description":"Cursor to paginate through results"}},"required":[],"additionalProperties":false},"example":{"domain":"lululemon.com"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"google-ad-library","data":{"success":true,"ads":[{"advertiserId":"AR01614014350098432001","creativeId":"CR08567627846124568577","format":"image","adUrl":"https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR08567627846124568577","advertiserName":"lululemon athletica canada inc.","imageUrl":null,"firstShown":"2026-03-11T17:08:22.000Z","lastShown":"2026-05-04T17:59:12.000Z"}],"cursor":"CgoAP7zmu%2FzKj6ijEhBBAgiPtk1y16J9lpkAAAAAGgn8%2BHbW%2BJylE6g%3D","number_of_ads_estimate":20000},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/google/ad":{"post":{"operationId":"social_google_ad","x-nexscope-slug":"social-google-ad","summary":"Google Ad Library Ad Details","description":"Retrieves detailed information about a specific Google ad including advertiserId, creativeId, format, firstShown, lastShown, and overallImpressions. firstShown can be null even when /v1/google/company/ads returns a date for the same ad; keep the company-list date when this field is null. When Google publishes political-ad transparency data, spend contains the currency and amount bounds, while targeting contains included and excluded age, gender, and location criteria. Targeted locations include their Google criterion ID, display name, full name, and country codes. Optional fields are null when Google does not publish them. regionStats and platformImpressions use lower and upper impression bounds. Variations are best-effort, omit unparseable entries, and have creative-type-dependent fields; image creatives can expose an images array. Text extraction uses OCR, so accuracy may vary. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Google Ad Library Ad Details API View Pricing Get Google ad details. firstShown can be null even when the company list has a date. Ad text uses OCR and may contain errors. 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The url of the ad"},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://adstransparency.google.com/advertiser/AR07541154843046445057/creative/CR17778900238552006657"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"google-ad-library","data":{"success":true,"advertiserId":"AR07541154843046445057","creativeId":"CR17778900238552006657","firstShown":"2026-06-05T21:52:15.000Z","url":"https://adstransparency.google.com/advertiser/AR07541154843046445057/creative/CR17778900238552006657","lastShown":"2026-06-24T19:04:54.000Z","format":"image","overallImpressions":{"min":"500000","max":"600000"},"spend":{"currency":"USD","lower":"5000","upper":"6000"},"targeting":{"age":{"included":["25-34"],"excluded":["18-24"]},"gender":{"included":["female"],"excluded":[]},"location":{"included":[{"criterionId":"2840","name":"United States","fullName":"United States","countryCodes":["US"]}],"excluded":[{"criterionId":"2578","name":"Norway","fullName":"Norway","countryCodes":["NO"]}]}},"creativeRegions":[{"regionCode":"US","regionName":"United States"}],"regionStats":[{"regionCode":"US","regionName":"United States","firstShown":"2026-06-05T00:00:00.000Z","lastShown":"2026-06-24T00:00:00.000Z","impressions":{"lower":"500000","upper":"600000"},"platformImpressions":[]}],"variations":[{"destinationUrl":"shop.gop.com","headline":"Classic GOP Quarter - Zip Pullover | Shop American ... Classic GOP Moisture Wicking Polo Shirt XL / Red Classic GOP Hat White / White Classic GOP Quarter - Zip Pullover | Shop American ... Official Party Quarter - Zip Pullover M / GOLD Classic GOP Hat Red / White","description":"FORE MORE Official Party Quarter - Zip Pullover XL / US FLAG Classic GOP Hat White / Red DJT Triple Threat Hat AMERICA America Swings Right T- Shirt XL / White Browse More","allText":"Official GOP Shop 寬 shop.gop.com Classic GOP Quarter - Zip Pullover | Shop American ... Classic GOP Moisture Wicking Polo Shirt XL / Red Fi Classic GOP Hat White / White Classic GOP Quarter - Zip Pullover | Shop American ... Official Party Quarter - Zip Pullover M / GOLD Classic GOP Hat Red / White D FORE MORE YEARS Official Party Quarter - Zip Pullover XL / US FLAG Classic GOP Hat White / Red DJT Triple Threat Hat AMERICA RIGHT America Swings Right T- Shirt XL / White Browse More","imageUrl":"https://tpc.googlesyndication.com/archive/simgad/18242167605449878359"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/google/adLibrary/advertisers/search":{"post":{"operationId":"social_google_ad_library_advertisers_search","x-nexscope-slug":"social-google-ad-library-advertisers-search","summary":"Google Ad Library Advertiser Search","description":"Searches the Google Ad Transparency Library for advertisers by name. Returns a list of matching advertisers with their name, advertiser_id, and region, plus a list of associated website domains. Use the returned advertiser_id to look up a company's ads. Defaults to US when region is not passed, so pass a 2-letter country code like AU or CA when searching for advertisers in another region. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Google Ad Library Advertiser Search API View Pricing Search the Google Ad Transparency Library for advertisers to get their advertiser id. Pass region for non-US advertisers, like AU or CA. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"The query to search for"},"region":{"type":"string","description":"2-letter country code to search in. Defaults to US when omitted."}},"required":["query"],"additionalProperties":false},"example":{"query":"lululemon"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"google-ad-library","data":{"success":true,"advertisers":[{"name":"lululemon HK Limited","advertiser_id":"AR01382517811867287553","region":"HK","number_of_ads_estimate":5}],"websites":[{"domain":"lululemon.de"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/linkedin/ads/search":{"post":{"operationId":"social_linkedin_ads_search","x-nexscope-slug":"social-linkedin-ads-search","summary":"LinkedIn Ad Library Search Ads","description":"Searches the LinkedIn Ad Library by company name, keyword, or companyId with optional country and date filters. Custom date filtering requires both startDate and endDate. LinkedIn accepts dates from the date one year ago through yesterday. Each ad includes id, description, headline, adType, advertiser, targeting details, image or video URLs, totalImpressions, and impressionsByCountry. Date and impression fields are nullable when LinkedIn does not expose them on the public ad page. Supports pagination via paginationToken. Search results keep a consistent field set when detail hydration fails, with null or empty defaults for unavailable fields. The existing image, video, organicVideo, preRollVideo, and carouselImages fields keep their previous values. paidForBy is the public paying entity when LinkedIn shows one, without the 'Paid for by' prefix. targetingTable lists the public targeting-category flags that LinkedIn shows; it does not expand a collapsed location summary into individual locations. imageSources and thumbnailSources list the creative-image and video-poster URLs LinkedIn supplies. videoSources lists native video renditions as { src, type, bitrate }; preRollVideoSources uses the same structure but contains only pre-roll ad video. type and bitrate are null when absent; bitrate is in bits per second. Choose the lowest positive bitrate for a smaller video download, rather than assuming source order ranks quality. All four source fields are arrays and are empty when unavailable. Document-cover previews are included in imageSources where available, including search fallback results. LinkedIn may expose only one image or thumbnail resolution; URLs are signed and should not be rewritten to guess smaller sizes. Search detail hydration is best-effort, so blocked or timed-out detail fetches can leave videoSources empty even for a video ad. No extra parameter or credit charge is required. adDuration is the ad availability date-range text, not video playback duration; it is an empty string with null startDate/endDate when LinkedIn does not publish the availability block. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. LinkedIn Ad Library Search Ads API View Pricing Search the LinkedIn Ad Library with native media variants where available. LinkedIn may expose only one image or thumbnail size. 1 credit per request\nSearches the LinkedIn Ad Library by company name, keyword, or companyId with optional country and date filters. Custom date filtering requires both startDate and endDate. LinkedIn accepts dates from the date one year ago through yesterday. Each ad includes id, description, headline, adType, advertiser, targeting details, image or video URLs, totalImpressions, and impressionsByCountry. Date and impression fields are nullable when LinkedIn does not expose them on the public ad page. Supports pagination via paginationToken. Search results keep a consistent field set when detail hydration fails, with null or empty defaults for unavailable fields. The existing image, video, organicVideo, preRollVideo, and carouselImages fields keep their previous values. paidForBy is the public paying entity when LinkedIn shows one, without the 'Paid for by' prefix. targetingTable lists the public targeting-category flags that LinkedIn shows; it does not expand a collapsed location summary into individual locations. imageSources and thumbnailSources list the creative-image and video-poster URLs LinkedIn supplies. videoSources lists native video renditions as { src, type, bitrate }; preRollVideoSources uses the same structure but contains only pre-roll ad video. type and bitrate are null when absent; bitrate is in bits per second. Choose the lowest positive bitrate for a smaller video download, rather than assuming source order ranks quality. All four source fields are arrays and are empty when unavailable. Document-cover previews are included in imageSources where available, including search fallback results. LinkedIn may expose only one image or thumbnail resolution; URLs are signed and should not be rewritten to guess smaller sizes. Search detail hydration is best-effort, so blocked or timed-out detail fetches can leave videoSources empty even for a video ad. No extra parameter or credit charge is required. adDuration is the ad availability date-range text, not video playback duration; it is an empty string with null startDate/endDate when LinkedIn does not publish the availability block.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"string","description":"The company name to search for. 'Microsoft' for example"},"keyword":{"type":"string","description":"The keyword to search for"},"companyId":{"type":"string","description":"The company id to search for"},"countries":{"type":"string","description":"Comma separated list of countries. Example: US,CA,MX"},"startDate":{"type":"string","description":"Start date in YYYY-MM-DD format. Must be used with endDate and cannot be earlier than the date one year ago."},"endDate":{"type":"string","description":"End date in YYYY-MM-DD format. Must be used with startDate and cannot be today or a future date."},"paginationToken":{"type":"string","description":"Pagination token to paginate through results"}},"required":[],"additionalProperties":false},"example":{"company":"microsoft"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"linkedin-ad-library","data":{"success":true,"ads":[{"id":"1629532086","description":"Offensive security for Insurance Brokers, TPAs, MGAs and Carriers.\n\nGet a full audit-grade NYDFS or SOC2 PDF report within 48 hours.","headline":"Meet us at Booth 3240","poster":"CodeAnt AI","posterTitle":null,"promotedBy":null,"targeting":{},"image":null,"video":"https://dms.licdn.com/playlist/vid/v2/D5610AQHhFKchr0EgUA/mp4-360p-30fp-crf28/B56aDdqz26GoCE-/0/1790425384702?e=2147483647&v=beta&t=JDvJ4pLmerMVdDjbUZskRZIeuno7_YD4b-t_y2aY_f0","preRollVideo":null,"organicVideo":"https://dms.licdn.com/playlist/vid/v2/D5610AQHhFKchr0EgUA/mp4-360p-30fp-crf28/B56aDdqz26GoCE-/0/1790425384702?e=2147483647&v=beta&t=JDvJ4pLmerMVdDjbUZskRZIeuno7_YD4b-t_y2aY_f0","preRollAdvertiser":null,"carouselImages":[],"url":"https://www.linkedin.com/ad-library/detail/1629532086","adType":"Video Ad","creativeType":"SPONSORED_VIDEO","advertiser":"CodeAnt AI","advertiserLinkedinPage":"https://www.linkedin.com/company/96582348","advertiserLogo":"https://media.licdn.com/dms/image/v2/D560BAQGncbvGj9h-YA/company-logo_100_100/company-logo_100_100/0/1700642866542/codeant_ai_logo?e=1793836800&v=beta&t=m3Yqh1eMA4FSBoIhNZzLkOQO8FLl84sq6rMUXuYaqXA","cta":"Join","sponsoredMessageSender":null,"sponsoredMessageSenderAvatar":null,"sponsoredMessageButtons":[],"destinationUrl":null,"landingPage":null,"adDuration":"","startDate":null,"endDate":null,"totalImpressions":null,"impressionsByCountry":[],"imageSources":[],"videoSources":[{"src":"https://dms.licdn.com/playlist/vid/v2/D5610AQHhFKchr0EgUA/mp4-360p-30fp-crf28/B56aDdqz26GoCE-/0/1790425384702?e=2147483647&v=beta&t=JDvJ4pLmerMVdDjbUZskRZIeuno7_YD4b-t_y2aY_f0","type":"video/mp4","bitrate":124294}],"thumbnailSources":["https://media.licdn.com/dms/image/v2/D5610AQHhFKchr0EgUA/videocover-high/B56aDdqz26GoBM-/0/1790425384196?e=2147483647&v=beta&t=f4890gDBvRXts6rJzik-j7iF8aDV6XOLTyaT10Bdkyg"],"preRollVideoSources":[]}],"paginationToken":"1587449116-1788316404963","isLastPage":false,"totalAds":258},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/linkedin/ad":{"post":{"operationId":"social_linkedin_ad","x-nexscope-slug":"social-linkedin-ad","summary":"LinkedIn Ad Library Ad Details","description":"Retrieves detailed information about a specific LinkedIn ad by URL. Returns id, description, headline, adType, advertiser, and targeting with language, location, and audience criteria. Also includes totalImpressions, impressionsByCountry, adDuration, startDate, and endDate. Date and impression fields are nullable when LinkedIn does not expose them on the public ad page. The existing image, video, organicVideo, preRollVideo, and carouselImages fields keep their previous values. paidForBy is the public paying entity when LinkedIn shows one, without the 'Paid for by' prefix. targetingTable lists the public targeting-category flags that LinkedIn shows; it does not expand a collapsed location summary into individual locations. imageSources and thumbnailSources list the creative-image and video-poster URLs LinkedIn supplies. videoSources lists native video renditions as { src, type, bitrate }; preRollVideoSources uses the same structure but contains only pre-roll ad video. type and bitrate are null when absent; bitrate is in bits per second. Choose the lowest positive bitrate for a smaller video download, rather than assuming source order ranks quality. All four source fields are arrays and are empty when unavailable. Document-cover previews are included in imageSources where available, including search fallback results. LinkedIn may expose only one image or thumbnail resolution; URLs are signed and should not be rewritten to guess smaller sizes. Search detail hydration is best-effort, so blocked or timed-out detail fetches can leave videoSources empty even for a video ad. No extra parameter or credit charge is required. adDuration is the ad availability date-range text, not video playback duration; it is an empty string with null startDate/endDate when LinkedIn does not publish the availability block. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. LinkedIn Ad Library Ad Details API View Pricing Get ad details and native media variants where available. LinkedIn may expose only one image or thumbnail size. 1 credit per request\nRetrieves detailed information about a specific LinkedIn ad by URL. Returns id, description, headline, adType, advertiser, and targeting with language, location, and audience criteria. Also includes totalImpressions, impressionsByCountry, adDuration, startDate, and endDate. Date and impression fields are nullable when LinkedIn does not expose them on the public ad page. The existing image, video, organicVideo, preRollVideo, and carouselImages fields keep their previous values. paidForBy is the public paying entity when LinkedIn shows one, without the 'Paid for by' prefix. targetingTable lists the public targeting-category flags that LinkedIn shows; it does not expand a collapsed location summary into individual locations. imageSources and thumbnailSources list the creative-image and video-poster URLs LinkedIn supplies. videoSources lists native video renditions as { src, type, bitrate }; preRollVideoSources uses the same structure but contains only pre-roll ad video. type and bitrate are null when absent; bitrate is in bits per second. Choose the lowest positive bitrate for a smaller video download, rather than assuming source order ranks quality. All four source fields are arrays and are empty when unavailable. Document-cover previews are included in imageSources where available, including search fallback results. LinkedIn may expose only one image or thumbnail resolution; URLs are signed and should not be rewritten to guess smaller sizes. Search detail hydration is best-effort, so blocked or timed-out detail fetches can leave videoSources empty even for a video ad. No extra parameter or credit charge is required. adDuration is the ad availability date-range text, not video playback duration; it is an empty string with null startDate/endDate when LinkedIn does not publish the availability block.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The url of the ad"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.linkedin.com/ad-library/detail/666281156"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"linkedin-ad-library","data":{"success":true,"id":"1629532086","description":"Offensive security for Insurance Brokers, TPAs, MGAs and Carriers.\n\nGet a full audit-grade NYDFS or SOC2 PDF report within 48 hours.","headline":"Meet us at Booth 3240","poster":"CodeAnt AI","targeting":{},"image":null,"video":"https://dms.licdn.com/playlist/vid/v2/D5610AQHhFKchr0EgUA/mp4-360p-30fp-crf28/B56aDdqz26GoCE-/0/1790425384702?e=2147483647&v=beta&t=JDvJ4pLmerMVdDjbUZskRZIeuno7_YD4b-t_y2aY_f0","preRollVideo":null,"organicVideo":"https://dms.licdn.com/playlist/vid/v2/D5610AQHhFKchr0EgUA/mp4-360p-30fp-crf28/B56aDdqz26GoCE-/0/1790425384702?e=2147483647&v=beta&t=JDvJ4pLmerMVdDjbUZskRZIeuno7_YD4b-t_y2aY_f0","preRollAdvertiser":null,"carouselImages":[],"url":"https://www.linkedin.com/ad-library/detail/1629532086","adType":"Video Ad","creativeType":"SPONSORED_VIDEO","advertiser":"CodeAnt AI","advertiserLinkedinPage":"https://www.linkedin.com/company/96582348","advertiserLogo":"https://media.licdn.com/dms/image/v2/D560BAQGncbvGj9h-YA/company-logo_100_100/company-logo_100_100/0/1700642866542/codeant_ai_logo?e=1793836800&v=beta&t=m3Yqh1eMA4FSBoIhNZzLkOQO8FLl84sq6rMUXuYaqXA","cta":"Join","sponsoredMessageSender":null,"sponsoredMessageSenderAvatar":null,"sponsoredMessageButtons":[],"destinationUrl":null,"landingPage":null,"adDuration":"","startDate":null,"endDate":null,"totalImpressions":null,"impressionsByCountry":[],"imageSources":[],"videoSources":[{"src":"https://dms.licdn.com/playlist/vid/v2/D5610AQHhFKchr0EgUA/mp4-360p-30fp-crf28/B56aDdqz26GoCE-/0/1790425384702?e=2147483647&v=beta&t=JDvJ4pLmerMVdDjbUZskRZIeuno7_YD4b-t_y2aY_f0","type":"video/mp4","bitrate":124294}],"thumbnailSources":["https://media.licdn.com/dms/image/v2/D5610AQHhFKchr0EgUA/videocover-high/B56aDdqz26GoBM-/0/1790425384196?e=2147483647&v=beta&t=f4890gDBvRXts6rJzik-j7iF8aDV6XOLTyaT10Bdkyg"],"preRollVideoSources":[]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/twitter/search/posts":{"post":{"operationId":"social_twitter_search_posts","x-nexscope-slug":"social-twitter-search-posts","summary":"Twitter Search Posts","description":"Finds public X/Twitter post URLs through Google Search, then returns their details using the same public post scraper as /v1/twitter/tweet. This is Google-indexed discovery, not native X search: coverage is incomplete, recent posts can be missing, and results are ranked by Google rather than newest first. Deleted, protected, or inaccessible posts are omitted. Each post uses the existing tweet response fields, including rest_id, legacy.full_text, legacy.created_at, engagement counts, author and media when available, plus a canonical url. Pass the returned cursor for the next Google page; cursors range from 1 through 11 and null means pagination has ended. The same post may appear on different pages. Each successful page costs 1 credit, including empty results; validation errors and upstream failures are not charged. Replaying cursor=null is uncharged. Allow at least 30 seconds for your client timeout. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Twitter Search Posts API View Pricing Search public X/Twitter posts by keyword using Google-indexed results, then fetch the post details without a logged-in X account. 1 credit per request\nFinds public X/Twitter post URLs through Google Search, then returns their details using the same public post scraper as /v1/twitter/tweet. This is Google-indexed discovery, not native X search: coverage is incomplete, recent posts can be missing, and results are ranked by Google rather than newest first. Deleted, protected, or inaccessible posts are omitted. Each post uses the existing tweet response fields, including rest_id, legacy.full_text, legacy.created_at, engagement counts, author and media when available, plus a canonical url. Pass the returned cursor for the next Google page; cursors range from 1 through 11 and null means pagination has ended. The same post may appear on different pages. Each successful page costs 1 credit, including empty results; validation errors and upstream failures are not charged. Replaying cursor=null is uncharged. Allow at least 30 seconds for your client timeout.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Keyword or phrase to search for in Google-indexed public X/Twitter posts"},"cursor":{"type":"string","description":"Pass the cursor returned by the previous response. Supported page cursors are 1 through 11. A null response cursor means there are no more pages."}},"required":["query"],"additionalProperties":false},"example":{"query":"ai agents"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"twitter","data":{"success":true,"query":"ai agents","posts":[{"rest_id":"2105732089685348719","url":"https://x.com/code_rams/status/2105732089685348719","views":{"count":"780","state":"EnabledWithCount"},"legacy":{"created_at":"Thu Oct 01 18:50:27 +0000 2026","full_text":"AI agents are checking your pricing page before your buyers do. Your analytics never shows it.\n\nHere's how to catch them and fix it:\n\n(Analysed and learned from my products)\n\n1. open your analytics or server logs and pull the last 30 days\n\n2. filter by user agent: GPTBot, https://t.co/HO75r0e5Am","favorite_count":11,"retweet_count":0,"reply_count":4,"quote_count":0,"bookmark_count":7}}],"cursor":"2"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/twitter/profile":{"post":{"operationId":"social_twitter_profile","x-nexscope-slug":"social-twitter-profile","summary":"Twitter Profile","description":"Retrieves a Twitter user's profile by handle, including account metadata and statistics. Returns name, screen_name, description, followers_count, friends_count, statuses_count, favourites_count, location, profile_image_url_https, and is_blue_verified. Also includes verification_info, tipjar_settings, highlights_info, and creator_subscriptions_count. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Twitter Profile API View Pricing Get Twitter profile information including stats and metadata 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Twitter handle"},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"Austen"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"twitter","data":{"success":true,"__typename":"User","id":"VXNlcjoyMjE4MzgzNDk=","rest_id":"221838349","affiliates_highlighted_label":{"label":{"url":{"url":"https://twitter.com/bloomtech","urlType":"DeepLink"},"badge":{"url":"https://pbs.twimg.com/profile_images/1542996246477938688/PR4UFtE6_bigger.jpg"},"description":"Bloom Institute of Technology","userLabelType":"BusinessLabel","userLabelDisplayType":"Badge"}},"is_blue_verified":true,"profile_image_shape":"Circle","legacy":{"created_at":"Wed Dec 01 19:13:23 +0000 2010","default_profile":false,"default_profile_image":false,"description":"CEO https://t.co/m6TigM5azr & https://t.co/NuPTghEZ1I (part of @bloomtech). We help teams maximize productivity using AI. Will tweet as I wish and suffer the consequences.","entities":{"description":{"urls":[{"display_url":"GauntletAI.com","expanded_url":"http://GauntletAI.com","url":"https://t.co/m6TigM5azr","indices":[4]}]},"url":{"urls":[{"display_url":"gauntletai.com","expanded_url":"http://gauntletai.com","url":"https://t.co/nCe0AdT8D4","indices":[0]}]}},"fast_followers_count":0,"favourites_count":80812,"followers_count":377608,"friends_count":1051,"has_custom_timelines":true,"is_translator":false,"listed_count":3959,"location":"Austin, TX","media_count":3843,"name":"Austen Allred","normal_followers_count":377608,"pinned_tweet_ids_str":["1882816395400073367"],"possibly_sensitive":false,"profile_banner_url":"https://pbs.twimg.com/profile_banners/221838349/1622098809","profile_image_url_https":"https://pbs.twimg.com/profile_images/1608281295918096385/D2kh-M28_normal.jpg","profile_interstitial_type":"","screen_name":"Austen","statuses_count":46114,"translator_type":"regular","url":"https://t.co/nCe0AdT8D4","verified":false,"withheld_in_countries":[]},"tipjar_settings":{"is_enabled":false,"bandcamp_handle":"","bitcoin_handle":"","cash_app_handle":"","ethereum_handle":"","gofundme_handle":"","patreon_handle":"","pay_pal_handle":"","venmo_handle":""},"legacy_extended_profile":{},"is_profile_translatable":false,"has_hidden_subscriptions_on_profile":false,"verification_info":{"is_identity_verified":false,"reason":{"description":{"text":"This account is verified because it's an affiliate of @bloomtech on X. Learn more","entities":[{"from_index":54,"to_index":64,"ref":{"url":"https://twitter.com/bloomtech","url_type":"ExternalUrl"}}]},"verified_since_msec":"1473330227634"}},"highlights_info":{"can_highlight_tweets":true,"highlighted_tweets":"482"},"user_seed_tweet_count":0,"business_account":{},"creator_subscriptions_count":3},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/twitter/user-tweets":{"post":{"operationId":"social_twitter_user_tweets","x-nexscope-slug":"social-twitter-user-tweets","summary":"Twitter User Tweets","description":"Fetches tweets from a Twitter user's profile by handle. Note: Twitter publicly returns only ~100 of the user's most popular tweets, not chronological or latest. Each tweet includes rest_id, full_text, views count, favorite_count, retweet_count, reply_count, bookmark_count, quote_count, created_at, media entities, and url. Supports a trim parameter for a lighter response. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Twitter User Tweets API View Pricing Get up to 100 popular tweets from a user's public profile, not their latest tweets. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Twitter handle"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"levelsio"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"twitter","data":{"success":true,"tweets":[{"rest_id":"1834021269559501236","views":{"count":"4710824","state":"EnabledWithCount"},"source":"<a href=\"http://twitter.com/download/iphone\" rel=\"nofollow\">Twitter for iPhone</a>","legacy":{"bookmark_count":2634,"bookmarked":false,"created_at":"Thu Sep 12 00:08:39 +0000 2024","conversation_id_str":"1834021269559501236","display_text_range":[0],"entities":{"hashtags":[],"symbols":[],"timestamps":[],"urls":[],"user_mentions":[]},"favorite_count":129276,"favorited":false,"full_text":"Wife: “What did your teacher remember about September 11th?”\n\nNine-year-old: “She was only four then, she doesn’t remember it at all.”","is_quote_status":false,"lang":"en","quote_count":674,"reply_count":388,"retweet_count":2901,"retweeted":false,"user_id_str":"221838349","id_str":"1834021269559501236"},"url":"https://x.com/Austen/status/1935730646267158797"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/twitter/tweet":{"post":{"operationId":"social_twitter_tweet","x-nexscope-slug":"social-twitter-tweet","summary":"Twitter Tweet Details","description":"Retrieves detailed information about a specific tweet by URL, including the author's profile and engagement metrics. Returns rest_id, full_text, views count, favorite_count, retweet_count, reply_count, bookmark_count, quote_count, created_at, source, and media entities. Supports a trim parameter for a lighter response. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Twitter Tweet Details API View Pricing Get detailed information about a specific tweet including engagement 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Tweet URL"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://x.com/servicenownews/status/2115575333076504613"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"twitter","data":{"success":true,"rest_id":"1935730646267158797","views":{"count":"27539","state":"EnabledWithCount"},"source":"<a href=\"https://mobile.twitter.com\" rel=\"nofollow\">Twitter Web App</a>","legacy":{"bookmark_count":95,"bookmarked":false,"created_at":"Thu Jun 19 16:05:24 +0000 2025","conversation_id_str":"1935730646267158797","display_text_range":[0],"entities":{"hashtags":[],"media":[{"display_url":"pic.x.com/YywdjQZde8","expanded_url":"https://x.com/Austen/status/1935730646267158797/photo/1","id_str":"1935730260303069184","indices":[149],"media_key":"3_1935730260303069184","media_url_https":"https://pbs.twimg.com/media/Gt0YanJWwAA6B80.jpg","type":"photo","url":"https://t.co/YywdjQZde8","ext_media_availability":{"status":"Available"},"allow_download_status":{"allow_download":true},"media_results":{"result":{"media_key":"3_1935730260303069184"}}}],"symbols":[],"timestamps":[],"urls":[],"user_mentions":[]},"extended_entities":{"media":[{"display_url":"pic.x.com/YywdjQZde8","expanded_url":"https://x.com/Austen/status/1935730646267158797/photo/1","id_str":"1935730260303069184","indices":[149],"media_key":"3_1935730260303069184","media_url_https":"https://pbs.twimg.com/media/Gt0YanJWwAA6B80.jpg","type":"photo","url":"https://t.co/YywdjQZde8","ext_media_availability":{"status":"Available"},"allow_download_status":{"allow_download":true},"media_results":{"result":{"media_key":"3_1935730260303069184"}}}]},"favorite_count":80,"favorited":false,"full_text":"This was created by a Gauntlet AI grad based on a whole lot of experimentation.\n\nOne of the most important things an AI dev can begin to understand. https://t.co/YywdjQZde8","is_quote_status":false,"lang":"en","possibly_sensitive":false,"possibly_sensitive_editable":true,"quote_count":3,"reply_count":6,"retweet_count":5,"retweeted":false,"user_id_str":"221838349","id_str":"1935730646267158797"}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/twitter/tweet/transcript":{"post":{"operationId":"social_twitter_tweet_transcript","x-nexscope-slug":"social-twitter-tweet-transcript","summary":"Twitter Transcript","description":"Extracts an AI transcript from a Twitter video tweet. This route uses AI transcription, not native captions. Returns a success flag and transcript text. No transcript costs 0 credits. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Twitter Transcript API View Pricing Get an AI transcript from a video tweet. Long videos may time out. Native captions or AI up to 2 minutes: 1 credit. Paid AI mode: 10 credits/minute, rounded up, even for short videos. No transcript: 0 credits.\nExtracts an AI transcript from a Twitter video tweet. This route uses AI transcription, not native captions. Returns a success flag and transcript text. No transcript costs 0 credits. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nPaid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (Returned native captions cost 1 credit, even for long videos with the paid flag. By default, successful AI up to 120 seconds costs a flat 1 credit per request; over 120 seconds requires allow_long_transcription=true, which bills ALL successful AI at 10 credits per started minute, including short videos; empty AI results and errors cost 0 credits; no transcript: 0 credits). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Tweet URL"},"allow_long_transcription":{"type":"boolean","default":false,"description":"Paid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed."},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (Returned native captions cost 1 credit, even for long videos with the paid flag. By default, successful AI up to 120 seconds costs a flat 1 credit per request; over 120 seconds requires allow_long_transcription=true, which bills ALL successful AI at 10 credits per started minute, including short videos; empty AI results and errors cost 0 credits; no transcript: 0 credits). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://x.com/TheoVon/status/1916982720317821050"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"twitter","data":{"success":true,"transcript":"Since you're kind of like a leader in innovation and technology in our world, you know, um do you how do you know that what your convictions are, how do you gauge if what your convictions are are the best for everybody kind of? Like how do you kind of figure that out, you know? It seems like such a challenge. I mean, look at the end of the day, um there are still a lot of options of things that people can do. Just because I build something doesn't mean that people are going to use it. Actually a lot of the things that I build like some of some of them work, some of them don't. And like I think part of the reason why the company has been successful is because, you know, maybe we have a slightly higher hit rate of things working than others. But if we do something that doesn't work, then in general people aren't going to use it. And then the future doesn't go in that direction. So I see. So you're saying it's up to the user more. Yeah, I mean look, it's always served me well to generally have faith in people and believe that people are smart and can make good decisions for themselves. And whenever we try to like adopt some sort of like attitude of oh we must know better than them. It's like we're like we're the people building technology. That's when you lose. So I I I tend to just think that at the end of the day, yeah, I mean I think people are smarter than than a lot of people think and I think ultimately drive the direction that society goes in."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/twitter/community":{"post":{"operationId":"social_twitter_community","x-nexscope-slug":"social-twitter-community","summary":"Twitter Community","description":"Retrieves details about a Twitter/X Community by URL. Returns the community name, description, rest_id, join_policy, created_at, member_count, rules, and creator_results with the creator's profile. Also includes members_facepile_results with avatar images of recent members. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Twitter Community API View Pricing Get X/Twitter Community details. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Community URL"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://x.com/i/communities/1926186499399139650"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"twitter","data":{"success":true,"__typename":"Community","is_member":false,"name":"The First Thousand","role":"NonMember","rest_id":"1926186499399139650","actions":{"join_action_result":{"__typename":"CommunityJoinActionUnavailable"},"id":"Q29tbXVuaXR5QWN0aW9uczoxOTI2MTg2NDk5Mzk5MTM5NjUw"},"description":"This community is for creators and builders who are growing to their first 1,000 followers. Give insights, build your brand, and grow a loyal audience.","creator_results":{"result":{"__typename":"User","id":"VXNlcjoxOTIxMzY4NDU0NDQ5MjAxMTUy","is_blue_verified":true,"core":{"screen_name":"CanaCarson"},"verification":{"verified":false}},"id":"VXNlclJlc3VsdHM6MTkyMTM2ODQ1NDQ0OTIwMTE1Mg=="},"join_policy":"Open","created_at":1748073622931,"rules":[{"rest_id":"1926189963793609186","description":"This isn’t the space to drop ChatGPT engineered empty platitudes","name":"No Empty Platitudes","id":"Q29tbXVuaXR5UnVsZToxOTI2MTg5OTYzNzkzNjA5MTg2"}],"members_facepile_results":[{"result":{"__typename":"User","avatar":{"image_url":"https://pbs.twimg.com/profile_images/1944871269775601664/Ho7tiGd2_normal.jpg"},"id":"VXNlcjoxOTIxMzY4NDU0NDQ5MjAxMTUy"},"id":"VXNlclJlc3VsdHM6MTkyMTM2ODQ1NDQ0OTIwMTE1Mg=="}],"member_count":1896,"id":"Q29tbXVuaXR5OjE5MjYxODY0OTkzOTkxMzk2NTA="},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/twitter/community/tweets":{"post":{"operationId":"social_twitter_community_tweets","x-nexscope-slug":"social-twitter-community-tweets","summary":"Twitter Community Tweets","description":"Fetches tweets posted within a Twitter/X Community by URL. Returns an array of tweets, each with id, full_text, view_count, favorite_count, retweet_count, reply_count, bookmark_count, quote_count, created_at, and source. Each tweet includes a user object with the author's name, screen_name, avatar, followers_count, and is_blue_verified status. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Twitter Community Tweets API View Pricing Get tweets from an X/Twitter Community. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Community URL"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://x.com/i/communities/1926186499399139650"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"twitter","data":{"success":true,"tweets":[{"id":"1940874916771123735","source":"<a href=\"http://twitter.com/download/iphone\" rel=\"nofollow\">Twitter for iPhone</a>","view_count":"8660","bookmark_count":10,"bookmarked":false,"created_at":"Thu Jul 03 20:46:54 +0000 2025","conversation_id_str":"1940874916771123735","display_text_range":[0],"favorite_count":173,"favorited":false,"full_text":"You just need 1 viral tweet https://t.co/Z4Q5jtsxAp","is_quote_status":false,"lang":"en","possibly_sensitive":false,"possibly_sensitive_editable":true,"quote_count":2,"reply_count":55,"retweet_count":3,"retweeted":false,"user_id_str":"73647967","id_str":"1940874916771123735","user":{"__typename":"User","id":"VXNlcjo3MzY0Nzk2Nw==","rest_id":"73647967","affiliates_highlighted_label":{},"avatar":{"image_url":"https://pbs.twimg.com/profile_images/1590652776719286274/eeualJ2p_normal.jpg"},"core":{"created_at":"Sat Sep 12 14:00:05 +0000 2009","name":"Mike in’ Software","screen_name":"mikeinsoftware"},"dm_permissions":{},"is_blue_verified":true,"legacy":{"default_profile":true,"default_profile_image":false,"description":"Senior SWE\uD83D\uDC68‍\uD83D\uDCBB Indie hacking my way to financial freedom \uD83D\uDC40 Follow for free early access to next project","entities":{"description":{"urls":[]}},"fast_followers_count":0,"favourites_count":7532,"followers_count":1173,"friends_count":990,"has_custom_timelines":true,"is_translator":false,"listed_count":8,"media_count":518,"normal_followers_count":1173,"pinned_tweet_ids_str":["1945599110876176561"],"possibly_sensitive":false,"profile_interstitial_type":"","statuses_count":2931,"translator_type":"none","withheld_in_countries":[]},"location":{"location":""},"media_permissions":{},"parody_commentary_fan_label":"None","profile_image_shape":"Circle","professional":{"rest_id":"1928057904189559014","professional_type":"Creator","category":[{"id":1055,"name":"Software developer/Programmer/Software engineer","icon_name":"IconBriefcaseStroke"}]},"privacy":{"protected":false},"relationship_perspectives":{},"tipjar_settings":{"is_enabled":false,"bandcamp_handle":"","bitcoin_handle":"","cash_app_handle":"","ethereum_handle":"","gofundme_handle":"","patreon_handle":"","pay_pal_handle":"","venmo_handle":""},"verification":{"verified":false}}}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/reddit/subreddit/details":{"post":{"operationId":"social_reddit_subreddit_details","x-nexscope-slug":"social-reddit-subreddit-details","summary":"Reddit Subreddit Details","description":"Retrieves metadata about a subreddit by name or URL. The subreddit name must be case-sensitive. Returns display_name, description, weekly_active_users, weekly_contributions, rules, icon_img, header_img, advertiser_category, submit_text, and created_at. Subscriber counts are not available. weekly_active_users and weekly_contributions measure weekly activity, not total subscribers. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Reddit Subreddit Details API View Pricing Get details about a subreddit. Pass a subreddit name or URL to the subreddit. Subscriber counts are not available; weekly activity counts are different metrics. 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name. MUST be case sensitive. So 'AskReddit' not 'askreddit'."},"url":{"type":"string","description":"Subreddit URL"},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":[],"additionalProperties":false},"example":{"url":"https://www.reddit.com/r/AbsoluteUnits/"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"reddit","data":{"success":true,"subreddit_id":"t5_a7wuv","display_name":"AbsoluteUnits","weekly_active_users":1428398,"weekly_contributions":8923,"rules":"#ABSOLUTE UNITS\n\n---\n\n    Be in awe at the size of these lads\n\n---\n\n###[Check out our deep, well-reflected definitions of an absolute unit.](https://www.reddit.com/r/AbsoluteUnits/wiki/index)  ","description":"Absolute Unit : an Animal or Public Figure, who is larger than we should normally expect.","header_img":null,"icon_img":"https://styles.redditmedia.com/t5_a7wuv/styles/communityIcon_t3cspt08bl681.png?width=128&frame=1&auto=webp&s=6f7e59ccf1724bd6c8b3e0d2840c9b21297102c3","advertiser_category":"","created_at":"2018-01-05T10:35:24.000Z","submit_text":""},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/reddit/subreddit":{"post":{"operationId":"social_reddit_subreddit","x-nexscope-slug":"social-reddit-subreddit","summary":"Reddit Subreddit Posts","description":"Fetches posts from a subreddit with sorting and filtering options. Each post includes title, author, link_flair_text when Reddit exposes it, selftext, score, ups, upvote_ratio, num_comments, created_utc, url, permalink, subreddit_subscribers, and is_video. Supports sort (best, hot, new, top, rising), timeframe filtering, pagination via the after token, and a trim parameter for lighter responses. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Reddit Subreddit Posts API View Pricing Get recent posts from a subreddit with engagement metrics 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name"},"timeframe":{"type":"string","enum":["all","day","week","month","year"],"description":"Timeframe to get posts from"},"sort":{"type":"string","enum":["best","hot","new","top","rising"],"description":"Sort order"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"},"after":{"type":"string","description":"After to get more posts. Get 'after' from previous response."}},"required":["subreddit"],"additionalProperties":false},"example":{"subreddit":"AskReddit"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"reddit","data":{"success":true,"posts":[{"id":"1lfbo7u","author":"Vetro_Nodulare2","author_fullname":"t2_16syu27ar1","subreddit":"AskReddit","title":"What is a thing you love that lots of people hate?","link_flair_text":null,"selftext":"","selftext_html":"","downs":0,"name":"t3_1lfbo7u","upvote_ratio":0.9,"ups":45,"total_awards_received":0,"score":45,"created":1750341959,"num_comments":349,"url":"https://www.reddit.com/r/AskReddit/comments/1lfbo7u/what_is_a_thing_you_love_that_lots_of_people_hate/","subreddit_subscribers":56146328,"is_video":false,"created_utc":1750341959}],"after":"t3_1lfogps"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/reddit/subreddit/search":{"post":{"operationId":"social_reddit_subreddit_search","x-nexscope-slug":"social-reddit-subreddit-search","summary":"Reddit Subreddit Search","description":"Searches within a specific subreddit for posts, comments, and media matching a query. Returns posts with title, votes, num_comments, url, and created_at; comments with author, body, votes, and parent post info; and media with title, media_type, image dimensions, and gallery_count. Supports sort, timeframe filtering, and cursor-based pagination. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Reddit Subreddit Search API View Pricing Search within a subreddit for posts, comments, or media matching a query 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name (e.g. 'Fitness', not 'r/Fitness' or a full URL)"},"query":{"type":"string","description":"Search query to find matching content"},"sort":{"type":"string","enum":["relevance","hot","top","new","comments"],"description":"Sort order. For posts/media: relevance, hot, top, new, comments. For comments: relevance, top, new"},"timeframe":{"type":"string","enum":["all","year","month","week","day","hour"],"description":"Timeframe to filter results"},"cursor":{"type":"string","description":"Cursor to get more results. Get 'cursor' from previous response."}},"required":["subreddit"],"additionalProperties":false},"example":{"subreddit":"AskReddit"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"reddit","data":{"success":true,"posts":[{"id":"t3_8gmjrb","post_id":"t3_8gmjrb","title":"Is doing 50-100 pushups a day doing anything?","url":"https://www.reddit.com/r/Fitness/comments/8gmjrb/is_doing_50100_pushups_a_day_doing_anything/","permalink":"/r/Fitness/comments/8gmjrb/is_doing_50100_pushups_a_day_doing_anything/","nsfw":false,"spoiler":false,"is_crosspost":false,"subreddit":{"id":"t5_2qhx4","name":"Fitness","nsfw":false,"quarantined":false,"icon":"https://b.thumbs.redditmedia.com/Ted4KOMuRbaCYlDS55cTqjpVVZ2ENHKtYFbBFjI1i2o.png","banner":null,"description":"A place for the pursuit of physical fitness goals.\n\nPlease see the r/Fitness Wiki and FAQ at https://thefitness.wiki for help with common questions.","weekly_visitors":898726,"weekly_contributions":1827},"votes":1414,"num_comments":582,"created_at":"2018-05-03T01:09:17.620000+0000","created_at_iso":"2018-05-03T01:09:17.620Z","thumbnail":null,"thumbnail_blurred":false,"position":0,"relative_position":0}],"comments":[{"id":"t1_nxf7p27","post_id":"t3_1q2p898","parent_comment_id":null,"is_reply_to_comment":false,"author":"Philser23","author_avatar":null,"author_nsfw":false,"body":"On the 30th my girlfriend out of the blue decided her new year's resolution would be to start going to the gym. I was so excited since none of my partners ever shared the fitness hobby with me.","body_html":"<p>On the 30th my girlfriend out of the blue decided her new year's resolution would be to start going to the gym...</p>","images":[],"votes":123,"url":"https://www.reddit.com/r/Fitness/comments/1q2p898/gym_story_saturday/nxf7p27/","permalink":"/r/Fitness/comments/1q2p898/gym_story_saturday/nxf7p27/","created_at":"2026-01-03T11:26:02.434000+0000","created_at_iso":"2026-01-03T11:26:02.434Z","post":{"id":"t3_1q2p898","title":"Gym Story Saturday","url":"https://www.reddit.com/r/Fitness/comments/1q2p898/gym_story_saturday/","permalink":"/r/Fitness/comments/1q2p898/gym_story_saturday/","nsfw":false,"spoiler":false,"votes":67,"num_comments":80,"created_at":"2026-01-03T08:15:49.709000+0000","created_at_iso":"2026-01-03T08:15:49.709Z"},"subreddit":{"id":"t5_2qhx4","name":"Fitness","nsfw":false,"quarantined":false,"icon":"https://b.thumbs.redditmedia.com/Ted4KOMuRbaCYlDS55cTqjpVVZ2ENHKtYFbBFjI1i2o.png"},"position":0}],"media":[{"id":"t3_geo4x","title":"Bodyweight training for really strong people. See on you're own what I mean with strong. (Not me)","url":"https://www.reddit.com/r/Fitness/comments/geo4x/bodyweight_training_for_really_strong_people_see/","permalink":"/r/Fitness/comments/geo4x/bodyweight_training_for_really_strong_people_see/","media_type":"image","video":null,"image":{"src":"https://external-preview.redd.it/X6lz5yGIzqVA5LcI9w-FsQJJHhXoCugDhsXgWW3I404.jpg?format=pjpg&auto=webp&s=46814b0a707a532e39e6c20851ddc1fefb0a111f","width":480,"height":360,"resolutions":[{"url":"https://external-preview.redd.it/X6lz5yGIzqVA5LcI9w-FsQJJHhXoCugDhsXgWW3I404.jpg?width=320&crop=smart&format=pjpg&auto=webp&s=144ac4171a1862e5d91d8dd90d44271e22a8273d","width":320}]},"gallery_count":null,"aspect_ratio":1.3333333333333333,"nsfw":false,"spoiler":false,"is_blurred":false,"subreddit":{"id":"t5_2qhx4","name":"Fitness","nsfw":false,"quarantined":false},"position":0,"safe_search":"UNAVAILABLE"}],"cursor":"eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2VjdGlvbl8xX3BpcGVsaW5lXzBfZ2xvYmFsX21vZGlmaWVyc1wiOlwiM1wiLFwic2VjdGlvbl8xX3BpcGVsaW5lXzFfbG9jYWxfbW9kaWZpZXJzXCI6XCIzXCIsXCJzZWN0aW9uXzJfcGlwZWxpbmVfNl9zY29wZV9zd2l0Y2hlclwiOlwiMFwiLFwic2VjdGlvbl8yX3BpcGVsaW5lXzdfcG9zdF9zZWFyY2hcIjpcIjdcIn0ifQ=="},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/reddit/postDetail":{"post":{"operationId":"social_reddit_post_detail","x-nexscope-slug":"social-reddit-post-detail","summary":"Reddit Post","description":"Retrieves public Reddit post details by URL without fetching or returning comments. Returns the text post body in selftext when present, plus the title, author, subreddit, score, upvote ratio, comment count, timestamps, permalink, and post flags. Accepts canonical Reddit post URLs and Reddit mobile share URLs. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Reddit Post API View Pricing Get information from a Reddit post without comments 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"url":{"type":"string","maxLength":2048,"minLength":1}},"additionalProperties":false,"type":"object","required":["url"]},"example":{"url":"https://www.reddit.com/r/coffee/comments/abc123/example/"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"platform":{"enum":["instagram","youtube","reddit","pinterest"],"type":"string"},"resourceStatus":{"enum":["AVAILABLE","PARTIAL","PRIVATE","RESTRICTED","NOT_FOUND","NO_TRANSCRIPT","UNKNOWN"],"type":"string"},"fetchedAt":{"format":"date-time","type":"string"},"sourceFetchedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"usage":{"properties":{"billingStatus":{"enum":["NOT_CHARGED","SETTLED","UNKNOWN"],"type":"string"},"chargedCredits":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["billingStatus","chargedCredits"]},"item":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"subreddit":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"anyOf":[{"type":"number"},{"type":"null"}]},"commentCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"upvoteRatio":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"author":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","handle"]},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","url","title","body","subreddit","publishedAt","score","commentCount","upvoteRatio","author"]},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["platform","resourceStatus","fetchedAt","sourceFetchedAt","usage","item"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"reddit","resourceStatus":"NOT_FOUND","fetchedAt":"2026-10-28T00:00:00Z","sourceFetchedAt":null,"usage":{"billingStatus":"UNKNOWN","chargedCredits":null},"item":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/reddit/postComments":{"post":{"operationId":"social_reddit_post_comments","x-nexscope-slug":"social-reddit-post-comments","summary":"Reddit Post Comments","description":"Retrieves comments and post details from a Reddit post by URL. Returns the post with title, author, score, ups, upvote_ratio, num_comments, and created_utc, plus a comments array where each comment includes author, body, body_html, score, created_utc, parent_id, permalink, and nested replies. Both GET and POST are supported. Use GET for normal requests. Pass one opaque cursor exactly as returned by more.cursor or replies.more.cursor to load the next page. Cursor batching and comma-separated cursor values are not supported. If an opaque cursor becomes too large after extensive pagination, use POST and send the same parameters in the JSON body. Supports cursor-based pagination for loading more comments and a trim parameter for lighter responses. Author flair fields are not available from this endpoint. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Reddit Post Comments API View Pricing Get Reddit post details and comments. Paginate with one opaque cursor; no cursor batching. For long cursors, use POST with the same JSON-body parameters. Author flair is unavailable. 1 credit per request GET /v1/reddit/post/comments\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"url":{"type":"string","maxLength":2048,"minLength":1},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"},"cursor":{"description":"Opaque single-page cursor, at most 65536 UTF-8 bytes.","type":"string","minLength":1}},"additionalProperties":false,"type":"object","required":["url"]},"example":{"url":"https://www.reddit.com/r/coffee/comments/abc123/example/"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"platform":{"enum":["instagram","youtube","reddit","pinterest"],"type":"string"},"resourceStatus":{"enum":["AVAILABLE","PARTIAL","PRIVATE","RESTRICTED","NOT_FOUND","NO_TRANSCRIPT","UNKNOWN"],"type":"string"},"fetchedAt":{"format":"date-time","type":"string"},"sourceFetchedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"usage":{"properties":{"billingStatus":{"enum":["NOT_CHARGED","SETTLED","UNKNOWN"],"type":"string"},"chargedCredits":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["billingStatus","chargedCredits"]},"post":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"subreddit":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"anyOf":[{"type":"number"},{"type":"null"}]},"commentCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"upvoteRatio":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"author":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","handle"]},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","url","title","body","subreddit","publishedAt","score","commentCount","upvoteRatio","author"]},{"type":"null"}]},"comments":{"items":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"postId":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"anyOf":[{"type":"number"},{"type":"null"}]},"author":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","handle"]},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","url","postId","parentId","body","publishedAt","score","author"]},"type":"array"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"additionalProperties":false,"type":"object","required":["platform","resourceStatus","fetchedAt","sourceFetchedAt","usage","post","comments","nextCursor","hasMore"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"reddit","resourceStatus":"NOT_FOUND","fetchedAt":"2026-10-28T00:00:00Z","sourceFetchedAt":null,"usage":{"billingStatus":"UNKNOWN","chargedCredits":null},"post":null,"comments":[],"nextCursor":null,"hasMore":false},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/reddit/post/transcript":{"post":{"operationId":"social_reddit_post_transcript","x-nexscope-slug":"social-reddit-post-transcript","summary":"Reddit Post Transcript","description":"Gets the transcript from a Reddit video post or direct v.redd.it URL when Reddit exposes a VTT caption file. Returns the raw WebVTT in raw_vtt plus a parsed plain-text transcript. If Reddit does not expose captions for the video, transcript is null and transcriptNotAvailable is true. Returned native captions cost 1 credit; empty transcripts and errors cost 0 credits. This endpoint does not use AI transcription. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Reddit Post Transcript API View Pricing Get the transcript from a Reddit video post 1 credit per request\nGets the transcript from a Reddit video post or direct v.redd.it URL when Reddit exposes a VTT caption file. Returns the raw WebVTT in raw_vtt plus a parsed plain-text transcript. If Reddit does not expose captions for the video, transcript is null and transcriptNotAvailable is true. Returned native captions cost 1 credit; empty transcripts and errors cost 0 credits. This endpoint does not use AI transcription.\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Reddit post URL or direct v.redd.it video URL"},"language":{"type":"string","description":"2 letter language code. Defaults to en."},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.reddit.com/r/youseeingthisshit/comments/1oiu9xm/football_nostalgiasaints_punter_head_coach_cant/"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"reddit","data":{"success":true,"url":"https://www.reddit.com/r/youseeingthisshit/comments/1oiu9xm/football_nostalgiasaints_punter_head_coach_cant/","post_id":"1oiu9xm","video_id":"eflpgc6r0zxf1","caption_url":"https://v.redd.it/eflpgc6r0zxf1/wh_ben_en.vtt","language":"en","raw_vtt":"WEBVTT\n\n00:00.000 --> 00:00.300\n<u>stop</u> on third down and now Barnhart I\nhanging\n\n00:00.300 --> 00:00.560\nstop <u>on</u> third down and now Barnhart I\nhanging","transcript":"stop on third down and now Barnhart I hanging spiraling punts touch back Barnhart could not pull it up short of the end zone...","transcriptNotAvailable":false},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/reddit/search":{"post":{"operationId":"social_reddit_search","x-nexscope-slug":"social-reddit-search","summary":"Reddit Search","description":"Searches across all of Reddit for posts or comments matching a query. Set filter to posts (the default) or comments. Post results include title, author, selftext, subreddit, score, ups, num_comments, created_utc, url, permalink, and is_video. Comment results include the matching body, author, votes, timestamps, comment URL, parent relationship, and post/subreddit context. Comment searches support relevance, new, and top sorting. Timeframe filtering applies to post searches. Pagination uses the after token, and trim returns a lighter response. upvote_ratio and subreddit_subscribers are currently null in post search results. To get upvote_ratio, pass the post URL to /v1/reddit/post; the ratio is returned at the top level. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Reddit Search API View Pricing Search Reddit for posts or comments. Search does not return upvote ratios or subscriber counts. Use /v1/reddit/post for a post's upvote_ratio. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keyword":{"type":"string","maxLength":1000,"minLength":1},"filter":{"enum":["posts","comments"],"type":"string","default":"posts"},"sort":{"enum":["relevance","new","top","comment_count"],"type":"string","default":"relevance"},"timeframe":{"enum":["all","day","week","month","year"],"type":"string","default":"all"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"},"cursor":{"description":"Opaque single-page cursor, at most 65536 UTF-8 bytes.","type":"string","minLength":1}},"additionalProperties":false,"type":"object","required":["keyword"],"allOf":[{"if":{"properties":{"filter":{"const":"comments"}},"required":["filter"]},"then":{"not":{"anyOf":[{"required":["timeframe"]},{"properties":{"sort":{"const":"comment_count"}},"required":["sort"]}]}}}]},"example":{"keyword":"coffee"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"platform":{"enum":["instagram","youtube","reddit","pinterest"],"type":"string"},"resourceStatus":{"enum":["AVAILABLE","PARTIAL","PRIVATE","RESTRICTED","NOT_FOUND","NO_TRANSCRIPT","UNKNOWN"],"type":"string"},"fetchedAt":{"format":"date-time","type":"string"},"sourceFetchedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"usage":{"properties":{"billingStatus":{"enum":["NOT_CHARGED","SETTLED","UNKNOWN"],"type":"string"},"chargedCredits":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["billingStatus","chargedCredits"]},"items":{"items":{"oneOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"subreddit":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"anyOf":[{"type":"number"},{"type":"null"}]},"commentCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"upvoteRatio":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"author":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","handle"]},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","url","title","body","subreddit","publishedAt","score","commentCount","upvoteRatio","author"]},{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"postId":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"anyOf":[{"type":"number"},{"type":"null"}]},"author":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","handle"]},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","url","postId","parentId","body","publishedAt","score","author"]}]},"type":"array"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"additionalProperties":false,"type":"object","required":["platform","resourceStatus","fetchedAt","sourceFetchedAt","usage","items","nextCursor","hasMore"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"reddit","resourceStatus":"NOT_FOUND","fetchedAt":"2026-10-28T00:00:00Z","sourceFetchedAt":null,"usage":{"billingStatus":"UNKNOWN","chargedCredits":null},"items":[],"nextCursor":null,"hasMore":false},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/truthsocial/profile":{"post":{"operationId":"social_truthsocial_profile","x-nexscope-slug":"social-truthsocial-profile","summary":"Truth Social Profile","description":"Retrieves a Truth Social user's public profile including display_name, username, avatar, header, followers_count, following_count, statuses_count, verified status, website, and created_at. Only prominent public figures (e.g., Trump, Vance) are accessible without authentication; most other accounts will not work. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Truth Social Profile API View Pricing Get Truth Social profile info 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Truth Social username"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"realDonaldTrump"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"truth-social","data":{"success":true,"id":"107780257626128497","username":"realDonaldTrump","acct":"realDonaldTrump","display_name":"Donald J. Trump","locked":false,"bot":false,"discoverable":null,"group":false,"created_at":"2022-02-11T16:16:57.705Z","note":"<p></p>","url":"https://truthsocial.com/@realDonaldTrump","avatar":"https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/avatars/107/780/257/626/128/497/original/454286ac07a6f6e6.jpeg","avatar_static":"https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/avatars/107/780/257/626/128/497/original/454286ac07a6f6e6.jpeg","header":"https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/headers/107/780/257/626/128/497/original/ba3b910ba387bf4e.jpeg","header_static":"https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/headers/107/780/257/626/128/497/original/ba3b910ba387bf4e.jpeg","followers_count":9528475,"following_count":72,"statuses_count":26249,"last_status_at":"2025-04-10","verified":true,"location":"","website":"www.DonaldJTrump.com","accepting_messages":false,"chats_onboarded":true,"feeds_onboarded":true,"tv_onboarded":false,"bookmarks_onboarded":false,"show_nonmember_group_statuses":false,"pleroma":{"accepts_chat_messages":false},"tv_account":false,"receive_only_follow_mentions":false,"emojis":[],"fields":[]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/truthsocial/user/posts":{"post":{"operationId":"social_truthsocial_user_posts","x-nexscope-slug":"social-truthsocial-user-posts","summary":"Truth Social User Posts","description":"Fetches a paginated list of posts from a Truth Social user, returning text, id, created_at, url, content, account info, media_attachments, card link previews, replies_count, reblogs_count, and favourites_count. Supports pagination via next_max_id and a trim option for lighter responses. Only prominent public figures (e.g., Trump, Vance) are accessible without authentication. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Truth Social User Posts API View Pricing Get posts from prominent public Truth Social accounts, such as Trump and Vance. Most other accounts require login and are unavailable. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Truth Social username"},"user_id":{"type":"string","description":"Truth Social user id. Use this for faster response times. Trumps is 107780257626128497. It is the 'id' field in the profile endpoint."},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"},"next_max_id":{"type":"string","description":"Used to paginate to next page"}},"required":[],"additionalProperties":false},"example":{"handle":"realDonaldTrump"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"truth-social","data":{"success":true,"posts":[{"id":"114712957163880045","text":"","created_at":"2025-06-20T00:53:36.183Z","language":null,"url":"https://truthsocial.com/@realDonaldTrump/114712957163880045","replies_count":58,"reblogs_count":165,"favourites_count":630,"upvotes_count":630,"downvotes_count":0,"media_attachments":[{"id":"114712956416948688","type":"video","url":"https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/media_attachments/files/114/712/956/416/948/688/original/3f067916e3c0c704.mp4","preview_url":"https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/media_attachments/thumbnails/114/712/956/416/948/688/original/6e823189e7100622.jpg","external_video_id":"v6surln","remote_url":null,"preview_remote_url":null,"text_url":null,"meta":{"colors":{"accent":"#e4e1ec","background":"#1d1c22","foreground":"#e4e1ec"},"original":{"bitrate":1682510,"duration":138.176,"frame_rate":"25/1","height":720,"width":1280},"small":{"aspect":1.7783333333333333,"height":600,"size":"1067x600","width":1067}},"description":null,"blurhash":"UE9%rEt9%ObH_4RibIRjtQWBjbjaNFoft7WB","processing":"complete"}]}],"next_max_id":"114711182786951532"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/truthsocial/post":{"post":{"operationId":"social_truthsocial_post","x-nexscope-slug":"social-truthsocial-post","summary":"Truth Social Post","description":"Fetches a single Truth Social post by URL, returning text, id, created_at, url, content, account details, media_attachments, card link previews, replies_count, reblogs_count, and favourites_count. Set download_media=true to download attached images or video and return permanent Supabase URLs. Only posts from prominent public figures (e.g., Trump, Vance) are accessible without authentication. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Truth Social Post API View Pricing Get Truth Social post 1 credit per request\nSet to true to download the attached video/images and get back permanent Supabase URLs. Costs 10 credits if media is found, 1 credit otherwise.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Truth Social post URL"},"download_media":{"type":"boolean","description":"Set to true to download the attached video/images and get back permanent Supabase URLs. Costs 10 credits if media is found, 1 credit otherwise."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://truthsocial.com/@realDonaldTrump/posts/114315219437063160"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"truth-social","data":{"success":true,"text":"It’s so hard to watch as Highly Qualified and Respected Ambassadors, who we desperately need representing our Country in Faraway Lands, are purposefully meant to wait as the Democrat Senators take maximum time for every single one of them, even though they were confirmed with Bipartisan Support, also at maximum time, and only done to hurt our Country. A process that should take a matter of minutes is forced into taking months, making it very hard on the new Ambassadors’ families, and not good, at all, for the Good Ole’ U.S.A. In a true sense, in numerous cases, what they do is actually a Threat to National Security. John Thune and the Republicans are doing a great job, but nothing much can be done when the Democrats make everyone sit, day after day, pushing the limits. The level of hostility is not to be believed!","id":"114315219437063160","created_at":"2025-04-10T19:03:40.023Z","in_reply_to_id":null,"quote_id":null,"in_reply_to_account_id":null,"sensitive":false,"spoiler_text":"","visibility":"public","language":"en","uri":"https://truthsocial.com/@realDonaldTrump/114315219437063160","url":"https://truthsocial.com/@realDonaldTrump/114315219437063160","content":"<p>It’s so hard to watch as Highly Qualified and Respected Ambassadors, who we desperately need representing our Country in Faraway Lands, are purposefully meant to wait as the Democrat Senators take maximum time for every single one of them, even though they were confirmed with Bipartisan Support, also at maximum time, and only done to hurt our Country. A process that should take a matter of minutes is forced into taking months, making it very hard on the new Ambassadors’ families, and not good, at all, for the Good Ole’ U.S.A. In a true sense, in numerous cases, what they do is actually a Threat to National Security. John Thune and the Republicans are doing a great job, but nothing much can be done when the Democrats make everyone sit, day after day, pushing the limits. The level of hostility is not to be believed!</p>","account":{"id":"107780257626128497","username":"realDonaldTrump","acct":"realDonaldTrump","display_name":"Donald J. Trump","locked":false,"bot":false,"discoverable":false,"group":false,"created_at":"2022-02-11T16:16:57.705Z","note":"<p></p>","url":"https://truthsocial.com/@realDonaldTrump","avatar":"https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/avatars/107/780/257/626/128/497/original/454286ac07a6f6e6.jpeg","avatar_static":"https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/avatars/107/780/257/626/128/497/original/454286ac07a6f6e6.jpeg","header":"https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/headers/107/780/257/626/128/497/original/ba3b910ba387bf4e.jpeg","header_static":"https://static-assets-1.truthsocial.com/tmtg:prime-ts-assets/accounts/headers/107/780/257/626/128/497/original/ba3b910ba387bf4e.jpeg","followers_count":9528704,"following_count":72,"statuses_count":26249,"last_status_at":"2025-04-10","verified":true,"location":"","website":"www.DonaldJTrump.com","unauth_visibility":true,"chats_onboarded":true,"feeds_onboarded":true,"accepting_messages":false,"show_nonmember_group_statuses":null,"emojis":[],"fields":[],"tv_onboarded":false,"tv_account":false},"media_attachments":[],"mentions":[],"tags":[],"card":null,"group":null,"quote":null,"in_reply_to":null,"reblog":null,"sponsored":false,"replies_count":797,"reblogs_count":2423,"favourites_count":8552,"favourited":false,"reblogged":false,"muted":false,"pinned":false,"bookmarked":false,"poll":null,"emojis":[]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/threads/profile":{"post":{"operationId":"social_threads_profile","x-nexscope-slug":"social-threads-profile","summary":"Threads Profile","description":"Retrieves a Threads user's public profile including username, full_name, biography, profile_pic_url, follower_count, is_verified, bio_links, and hd_profile_pic_versions. Also indicates whether the account is a threads-only user via is_threads_only_user. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Threads Profile API View Pricing Get Threads profile info 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Threads username"},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"trendspider"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"threads","data":{"success":true,"pk":"63496592589","text_post_app_is_private":false,"has_onboarded_to_text_post_app":true,"friendship_status":null,"profile_pic_url":"https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/483433564_655589117415062_7541542786235693538_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHDtD3999Ou4pcMMH7DERwg7b_8MUH39VGHj-ZYaqdB2I3m-ESqs1jnoXQnYBB1LuxmAKVJiGexqr1KcbyKld_3&_nc_ohc=jnD03vDTtYoQ7kNvwH8q9Xl&_nc_gid=El4dvFdafrjTWXuQgkba9Q&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfGGVFQMzxW19jgaoPNQhfTiZt4Hrkmgq1cnt5iWpEGqxA&oe=67FFAFC8&_nc_sid=10d13b","username":"sportsillustrated","text_post_app_remove_mention_entrypoint":null,"show_text_post_app_replies_tab":true,"text_app_custom_feeds":null,"gating":null,"follower_count":551296,"profile_context_facepile_users":null,"hd_profile_pic_versions":[{"height":320,"url":"https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/483433564_655589117415062_7541542786235693538_n.jpg?stp=dst-jpg_s320x320_tt6&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHDtD3999Ou4pcMMH7DERwg7b_8MUH39VGHj-ZYaqdB2I3m-ESqs1jnoXQnYBB1LuxmAKVJiGexqr1KcbyKld_3&_nc_ohc=jnD03vDTtYoQ7kNvwH8q9Xl&_nc_gid=El4dvFdafrjTWXuQgkba9Q&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfFikDi79lRI5uOb6TB0xYEkQwPWwZ1haHqpW4B-uDFVMw&oe=67FFAFC8&_nc_sid=10d13b","width":320}],"is_verified":true,"biography":"Sports, sports and more sports.","text_app_biography":{"text_fragments":{"fragments":[{"fragment_type":"plaintext","link_fragment":null,"mention_fragment":null,"plaintext":"Sports, sports and more sports.","tag_fragment":null,"linkified_web_url":null}]}},"full_name":"Sports Illustrated","bio_links":[{"url":"https://lnk.bio/sportsillustrated","is_verified":false,"link_id":"17882982429146262"}],"transparency_label":null,"is_threads_only_user":false,"show_text_post_app_badge":true,"id":"63496592589"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/threads/user/posts":{"post":{"operationId":"social_threads_user_posts","x-nexscope-slug":"social-threads-user-posts","summary":"Threads Posts","description":"Fetches the most recent posts from a Threads user, returning id, caption text, code, like_count, reshare_count, direct_reply_count, repost_count, image_versions2, video_versions, and taken_at. Only the last 20-30 posts are publicly visible. Supports a trim option for lighter responses. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Threads Posts API View Pricing Get a user's public Threads posts, limited to roughly the latest 20–30 posts. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Threads username"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"trendspider"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"threads","data":{"success":true,"posts":[{"id":"3656367813102434565_63055343223","pk":"3656367813102434565","caption":{"text":"Spoiler alert: We're testing a way for you to hide spoilers in your Threads posts.","pk":"17978979272714446","has_translation":null},"code":"DK-BydcJHkF","like_count":96434,"taken_at":1750093031,"user":{"friendship_status":null,"pk":"63055343223","profile_pic_url":"https://scontent-hou1-1.cdninstagram.com/v/t51.2885-19/452737457_1313286386312102_744138929735022550_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-hou1-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QFGyGWANff-XHjZgOOWs_xNC29qmUTVstyb7y0tS-ajYvJSDJTf5fJ3qHVk4igARGY&_nc_ohc=4jx-dLM0V7UQ7kNvwEKpQFP&_nc_gid=butCRrRE5aFQP4QL-mwt9A&edm=AA3DLpEBAAAA&ccb=7-5&oh=00_AfMVigSXFw6UnanNMOzkIu2vA31TUJ_4uOlpGTH6q3dqTw&oe=685A71CE&_nc_sid=d92198","username":"zuck","id":"63055343223","transparency_label":null,"transparency_product":null,"transparency_product_enabled":false,"is_verified":true,"text_post_app_is_private":false,"has_onboarded_to_text_post_app":true},"url":"https://www.threads.com/@zuck/post/DK-BydcJHkF"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/threads/post":{"post":{"operationId":"social_threads_post","x-nexscope-slug":"social-threads-post","summary":"Threads Post","description":"Fetches a single Threads post by URL, returning the post's caption, like_count, view_counts, reshare_count, direct_reply_count, image_versions2, text_post_app_info, and taken_at. Also includes comments, threadItems, and relatedPosts arrays. threadItems contains public continuation posts by the original author and stays separate from comments. Supports a trim option for lighter responses. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Threads Post API View Pricing Get a post by url. Also returns comments, author continuations, and related posts. 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the post to get"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.threads.com/@trendspider/post/DIU8naHS6q_"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"threads","data":{"success":true,"post":{"id":"3656367813102434565_63055343223","pk":"3656367813102434565","caption":{"text":"Spoiler alert: We're testing a way for you to hide spoilers in your Threads posts.","pk":"17978979272714446","has_translation":null},"code":"DK-BydcJHkF","like_count":96439,"taken_at":1750093031,"user":{"pk":"63055343223","friendship_status":null,"profile_pic_url":"https://scontent-hou1-1.cdninstagram.com/v/t51.2885-19/452737457_1313286386312102_744138929735022550_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-hou1-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QEI0Na315cY5sOYUkhVVibfgPAW-ui7qHsdVtzXBXEOhzW7Bng-EMYZTcNDR7NhzDw&_nc_ohc=4jx-dLM0V7UQ7kNvwF5pEvj&_nc_gid=08CADhHYLnZPoVapLCtXQw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfMJZBcCbhMdKKqnrXmtnhF3bwCCjEU85Z3Ih0GWNi5t6A&oe=685A71CE&_nc_sid=10d13b","username":"zuck","id":"63055343223","full_name":"Mark Zuckerberg","transparency_label":null,"transparency_product":null,"transparency_product_enabled":false,"is_verified":true,"text_post_app_is_private":false,"has_onboarded_to_text_post_app":true}},"comments":[{"id":"3658534918151603488_74973899807","pk":"3658534918151603488","caption":{"text":"意味分からない","pk":"18306832783208063","has_translation":true},"code":"DLFuh_SygUg","like_count":0,"taken_at":1750351370,"user":{"pk":"74973899807","friendship_status":null,"profile_pic_url":"https://scontent-hou1-1.cdninstagram.com/v/t51.2885-19/491446152_17850244230449803_8764028655689505242_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-hou1-1.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QEI0Na315cY5sOYUkhVVibfgPAW-ui7qHsdVtzXBXEOhzW7Bng-EMYZTcNDR7NhzDw&_nc_ohc=04OF9jMRuJoQ7kNvwF4M8X7&_nc_gid=08CADhHYLnZPoVapLCtXQw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfOd6QqjNHAV2HNKm-I63jqf58-6kNsVTzATgKyd-iN3zw&oe=685A9A82&_nc_sid=10d13b","username":"emimimi_0917","id":"74973899807","full_name":"青木恵美","transparency_label":null,"transparency_product":null,"transparency_product_enabled":false,"is_verified":true,"text_post_app_is_private":false,"has_onboarded_to_text_post_app":true}}],"threadItems":[],"relatedPosts":[{"id":"3658572865166656590_63453315755","pk":"3658572865166656590","caption":{"text":"Initial findings of investigation into overnight ground explosion of SpaceX Starship rocket in Texas point to failure of a Composite Overwrapped Pressure Vessel (COPV), a lightweight storage tank containing nitrogen under high pressure. \uD83D\uDDA5️ X/Elon Musk","pk":"18345028147091883","has_translation":null},"code":"DLF3KMNJERO","like_count":15,"taken_at":1750355893,"user":{"pk":"63453315755","friendship_status":null,"profile_pic_url":"https://scontent-hou1-1.cdninstagram.com/v/t51.2885-19/402757276_161160320414682_3222955945465557227_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-hou1-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QGJAk0S-TOHB3ZWl6ci1q6t2XxgndYS-k6upqywpT-gXu8dlcxmH69UxCueQ9PIqQw&_nc_ohc=J3L5lDaaNDIQ7kNvwGO73Uq&_nc_gid=08CADhHYLnZPoVapLCtXQw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfMkWFXtSlvnwHnBZKBb9eFnleArkHhYt6m32PRKXpKNPA&oe=685AA3CD&_nc_sid=10d13b","username":"jonathanserrie","id":"63453315755","full_name":"Jonathan Serrie","transparency_label":null,"transparency_product":null,"transparency_product_enabled":false,"is_verified":true,"text_post_app_is_private":false,"has_onboarded_to_text_post_app":true}}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/threads/search":{"post":{"operationId":"social_threads_search","x-nexscope-slug":"social-threads-search","summary":"Threads Search by Keyword","description":"Searches Threads for posts matching a keyword, returning up to 10 results with caption text, like_count, reshare_count, direct_reply_count, user info, and image_versions2. Supports optional start_date and end_date filters plus a trim option. Only 10 results are returned per request due to public API limitations. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Threads Search by Keyword API View Pricing Search public Threads posts by keyword, up to 10 results per request. Repeat searches over time to find new results. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Keyword to search for"},"start_date":{"type":"string","description":"Start date to search for"},"end_date":{"type":"string","description":"End date to search for"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["query"],"additionalProperties":false},"example":{"query":"basketball"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"threads","data":{"success":true,"posts":[{"id":"3658605407757558624_71259204903","pk":"3658605407757558624","caption":{"text":"This woman selling mini umbrellas shows love to stray cats & dogs & introduces them. She may not have money but is richer than many.\uD83E\uDD79\uD83E\uDD79","pk":"18077403781726333","has_translation":null},"code":"DLF-jv2tmNg","like_count":5419,"taken_at":1750359780,"user":{"pk":"71259204903","friendship_status":null,"profile_pic_url":"https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-19/501402907_17869607802372904_1939177145792832486_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QHQ6tqymzxxWWnD3Y69dUStiwPULqhvwrOx1_1jXHmGEOp8LBdxfOkihhVQW0v5NsY&_nc_ohc=FICE0ht7dSAQ7kNvwEXdDzp&_nc_gid=C_fAfqKQ2OEy746wTYa0sw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfPyuWIMTTIwpoiGW4059hDGkyKRW8eVZbUH1Zfzd2xxRw&oe=685AA184&_nc_sid=10d13b","username":"mahtabuddinit","id":"71259204903","full_name":"Mahtab Uddin","transparency_label":null,"transparency_product":null,"transparency_product_enabled":false,"is_verified":false,"text_post_app_is_private":false,"has_onboarded_to_text_post_app":true}}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/threads/search/users":{"post":{"operationId":"social_threads_search_users","x-nexscope-slug":"social-threads-search-users","summary":"Threads Search Users","description":"Searches for Threads users by username, returning matching profiles with username, full_name, profile_pic_url, is_verified, and pk. Useful for finding user accounts before fetching their profile or posts. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Threads Search Users API View Pricing Search for users by username 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Username to search for"}},"required":["query"],"additionalProperties":false},"example":{"query":"shams"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"threads","data":{"success":true,"users":[{"username":"shams","pk":"5951152863","is_active_on_text_post_app":true,"full_name":"Shams Charania","profile_pic_url":"https://instagram.flas1-2.fna.fbcdn.net/v/t51.2885-19/482795192_3376548399146227_6340123271493467395_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=instagram.flas1-2.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2QGGqXP9vnbg6p9G1kF4lrIwvuvWx0OeJ6C8nPcAyo-_4m8XC-91nKJBOJb8u0utyuiAJMdjpjH1-dv5DBfEeQFp&_nc_ohc=SCH32yXVc04Q7kNvwEaKg6u&_nc_gid=7vwZl0t6h0jZxQ23lXCMVw&edm=AHhEZX8BAAAA&ccb=7-5&oh=00_AfEIzDlsXrO-ShRXs19ZmpyYb_9IbJC9dWAUyvar-NvZ_A&oe=681B5320&_nc_sid=e8efdc","is_verified":true,"has_onboarded_to_text_post_app":true,"id":"5951152863"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/bluesky/profile":{"post":{"operationId":"social_bluesky_profile","x-nexscope-slug":"social-bluesky-profile","summary":"Bluesky Profile","description":"Retrieves a Bluesky user's public profile including handle, displayName, avatar, description, followersCount, followsCount, postsCount, createdAt, and verification status. The associated field shows counts for lists, feed generators, and starter packs. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Bluesky Profile API View Pricing Get Bluesky profile info 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Bluesky handle"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"espn.com"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"bluesky","data":{"success":true,"did":"did:plc:x7d6j54pm22ufehkes6jo4jf","handle":"espn.com","displayName":"ESPN","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:x7d6j54pm22ufehkes6jo4jf/bafkreie4oxawqqsfzvk47ysr3unsnmviedzpylxmwxnpa534to2bzas4ie@jpeg","associated":{"lists":0,"feedgens":0,"starterPacks":0,"labeler":false},"labels":[],"createdAt":"2024-11-25T21:49:49.345Z","verification":{"verifications":[{"issuer":"did:plc:z72i7hdynmk6r22z27h6tvur","uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.verification/3lndppjqgb72f","isValid":true,"createdAt":"2025-04-21T10:44:20.398Z"}],"verifiedStatus":"valid","trustedVerifierStatus":"none"},"description":"Serving sports fans. Anytime. Anywhere.","indexedAt":"2024-12-19T20:49:48.843Z","followersCount":198477,"followsCount":32,"postsCount":659},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/bluesky/user/posts":{"post":{"operationId":"social_bluesky_user_posts","x-nexscope-slug":"social-bluesky-user-posts","summary":"Bluesky Posts","description":"Fetches a paginated feed of posts from a Bluesky user, returning each post's uri, record text, author info, embed content, replyCount, repostCount, likeCount, quoteCount, and indexedAt. Supports pagination via cursor. Use user_id (the 'did') instead of handle for faster response times. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Bluesky Posts API View Pricing Get Bluesky user posts. Use user_id for faster response times. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Bluesky handle"},"user_id":{"type":"string","description":"Bluesky 'did'. (For some reason Bluesky calls their user ids, 'did' for whatever reason)"}},"required":[],"additionalProperties":false},"example":{"handle":"espn.com"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"bluesky","data":{"success":true,"feed":[{"uri":"at://did:plc:x7d6j54pm22ufehkes6jo4jf/app.bsky.feed.post/3lqdfq7fkvm2g","cid":"bafyreibams5wyqdpg2cmmks7lhf5ccxu7hbu24sfatgc53jmb2nun5k5dm","author":{"did":"did:plc:x7d6j54pm22ufehkes6jo4jf","handle":"espn.com","displayName":"ESPN","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:x7d6j54pm22ufehkes6jo4jf/bafkreie4oxawqqsfzvk47ysr3unsnmviedzpylxmwxnpa534to2bzas4ie@jpeg","labels":[],"createdAt":"2024-11-25T21:49:49.345Z","verification":{"verifications":[{"issuer":"did:plc:z72i7hdynmk6r22z27h6tvur","uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.verification/3lndppjqgb72f","isValid":true,"createdAt":"2025-04-21T10:44:20.398Z"}],"verifiedStatus":"valid","trustedVerifierStatus":"none"}},"record":{"$type":"app.bsky.feed.post","createdAt":"2025-05-29T19:01:20.743Z","embed":{"$type":"app.bsky.embed.external","card":{"description":"The Oilers apparently will have defenseman Mattias Ekholm back in their lineup for Game 5 of the Western Conference finals against the Stars.","thumb":{"$type":"blob","ref":{"$link":"bafkreihhffgngv4thcnw7sh7o43qnwwyjvfemdlccwalu76r3vnhlbssle"},"mimeType":"image/jpeg","size":158648},"title":"Oilers' Ekholm set for return in Game 5 vs. Stars","uri":"http://spr.ly/63320N4OEy"},"external":{"description":"The Oilers apparently will have defenseman Mattias Ekholm back in their lineup for Game 5 of the Western Conference finals against the Stars.","thumb":{"$type":"blob","ref":{"$link":"bafkreihhffgngv4thcnw7sh7o43qnwwyjvfemdlccwalu76r3vnhlbssle"},"mimeType":"image/jpeg","size":158648},"title":"Oilers' Ekholm set for return in Game 5 vs. Stars","uri":"http://spr.ly/63320N4OEy"}},"facets":[],"text":"Oilers' defenseman Mattias Ekholm is set to return to action Thursday for Game 5 of the Western Conference finals against the Stars.\n\nEkholm has been out of the Oilers' lineup since April 11 with an undisclosed injury."},"embed":{},"replyCount":1,"repostCount":0,"likeCount":24,"quoteCount":1,"indexedAt":"2025-05-29T19:01:21.645Z","labels":[]}],"cursor":"2025-05-22T17:02:02.847Z"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/bluesky/post":{"post":{"operationId":"social_bluesky_post","x-nexscope-slug":"social-bluesky-post","summary":"Bluesky Post","description":"Fetches a single Bluesky post by URL, returning the post's record text, author info, embed content, replyCount, repostCount, likeCount, and quoteCount. Also includes a replies array with threaded reply posts. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Bluesky Post API View Pricing Get Bluesky post 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Bluesky post URL"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://bsky.app/profile/espn.com/post/3lqdfq7fkvm2g"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"bluesky","data":{"success":true,"post":{"uri":"at://did:plc:x7d6j54pm22ufehkes6jo4jf/app.bsky.feed.post/3lqdfq7fkvm2g","cid":"bafyreibams5wyqdpg2cmmks7lhf5ccxu7hbu24sfatgc53jmb2nun5k5dm","author":{"did":"did:plc:x7d6j54pm22ufehkes6jo4jf","handle":"espn.com","displayName":"ESPN","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:x7d6j54pm22ufehkes6jo4jf/bafkreie4oxawqqsfzvk47ysr3unsnmviedzpylxmwxnpa534to2bzas4ie@jpeg","labels":[],"createdAt":"2024-11-25T21:49:49.345Z","verification":{"verifications":[{"issuer":"did:plc:z72i7hdynmk6r22z27h6tvur","uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.verification/3lndppjqgb72f","isValid":true,"createdAt":"2025-04-21T10:44:20.398Z"}],"verifiedStatus":"valid","trustedVerifierStatus":"none"}},"record":{"$type":"app.bsky.feed.post","createdAt":"2025-05-29T19:01:20.743Z","embed":{"$type":"app.bsky.embed.external","card":{"description":"The Oilers apparently will have defenseman Mattias Ekholm back in their lineup for Game 5 of the Western Conference finals against the Stars.","thumb":{"$type":"blob","ref":{"$link":"bafkreihhffgngv4thcnw7sh7o43qnwwyjvfemdlccwalu76r3vnhlbssle"},"mimeType":"image/jpeg","size":158648},"title":"Oilers' Ekholm set for return in Game 5 vs. Stars","uri":"http://spr.ly/63320N4OEy"},"external":{"description":"The Oilers apparently will have defenseman Mattias Ekholm back in their lineup for Game 5 of the Western Conference finals against the Stars.","thumb":{"$type":"blob","ref":{"$link":"bafkreihhffgngv4thcnw7sh7o43qnwwyjvfemdlccwalu76r3vnhlbssle"},"mimeType":"image/jpeg","size":158648},"title":"Oilers' Ekholm set for return in Game 5 vs. Stars","uri":"http://spr.ly/63320N4OEy"}},"facets":[],"text":"Oilers' defenseman Mattias Ekholm is set to return to action Thursday for Game 5 of the Western Conference finals against the Stars.\n\nEkholm has been out of the Oilers' lineup since April 11 with an undisclosed injury."},"embed":{"$type":"app.bsky.embed.external#view","external":{"uri":"http://spr.ly/63320N4OEy","title":"Oilers' Ekholm set for return in Game 5 vs. Stars","description":"The Oilers apparently will have defenseman Mattias Ekholm back in their lineup for Game 5 of the Western Conference finals against the Stars.","thumb":"https://cdn.bsky.app/img/feed_thumbnail/plain/did:plc:x7d6j54pm22ufehkes6jo4jf/bafkreihhffgngv4thcnw7sh7o43qnwwyjvfemdlccwalu76r3vnhlbssle@jpeg"}},"replyCount":1,"repostCount":0,"likeCount":24,"quoteCount":1,"indexedAt":"2025-05-29T19:01:21.645Z","labels":[]},"replies":[{"$type":"app.bsky.feed.defs#threadViewPost","post":{"uri":"at://did:plc:dzsbhwnnvblrpyy2fpnmaih3/app.bsky.feed.post/3lqdii5jmmc2p","cid":"bafyreicrfgr5rge655xy6wsgmdiexanr2vhwib7fkjbgu4kku3gzjzwowu","author":{"did":"did:plc:dzsbhwnnvblrpyy2fpnmaih3","handle":"thinkasaurus.bsky.social","displayName":"Doris the Thinkasaurus","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:dzsbhwnnvblrpyy2fpnmaih3/bafkreielkwohfe37wdka5336fl2sxijxur242dhovdb2edkk56yuzl4fyu@jpeg","labels":[{"src":"did:plc:dzsbhwnnvblrpyy2fpnmaih3","uri":"at://did:plc:dzsbhwnnvblrpyy2fpnmaih3/app.bsky.actor.profile/self","cid":"bafyreihy26aqt7z6pn7uhqhoyh6ge5novekumdcsd3cxxz72nkc5bnozam","val":"!no-unauthenticated","cts":"2024-10-21T17:22:26.564Z"}],"createdAt":"2024-10-21T17:22:27.408Z"},"record":{"$type":"app.bsky.feed.post","createdAt":"2025-05-29T19:50:31.613Z","langs":["en"],"reply":{"parent":{"cid":"bafyreibams5wyqdpg2cmmks7lhf5ccxu7hbu24sfatgc53jmb2nun5k5dm","uri":"at://did:plc:x7d6j54pm22ufehkes6jo4jf/app.bsky.feed.post/3lqdfq7fkvm2g"},"root":{"cid":"bafyreibams5wyqdpg2cmmks7lhf5ccxu7hbu24sfatgc53jmb2nun5k5dm","uri":"at://did:plc:x7d6j54pm22ufehkes6jo4jf/app.bsky.feed.post/3lqdfq7fkvm2g"}},"text":"Alright! Now I have a reason to root for Edmonton aside from my burning hatred of Dallas!"},"replyCount":0,"repostCount":0,"likeCount":0,"quoteCount":0,"indexedAt":"2025-05-29T19:50:32.451Z","labels":[]},"replies":[],"threadContext":{}}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/pinterest/search":{"post":{"operationId":"social_pinterest_search","x-nexscope-slug":"social-pinterest-search","summary":"Pinterest Search","description":"Searches Pinterest for pins matching a query, returning results with id, url, title, description, images, link, domain, board info, and pinner details. Supports pagination via cursor and a trim option for lighter responses. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Pinterest Search API View Pricing Search Pinterest 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keyword":{"type":"string","maxLength":1000,"minLength":1},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"},"cursor":{"description":"Opaque single-page cursor, at most 65536 UTF-8 bytes.","type":"string","minLength":1}},"additionalProperties":false,"type":"object","required":["keyword"]},"example":{"keyword":"coffee"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"platform":{"enum":["instagram","youtube","reddit","pinterest"],"type":"string"},"resourceStatus":{"enum":["AVAILABLE","PARTIAL","PRIVATE","RESTRICTED","NOT_FOUND","NO_TRANSCRIPT","UNKNOWN"],"type":"string"},"fetchedAt":{"format":"date-time","type":"string"},"sourceFetchedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"usage":{"properties":{"billingStatus":{"enum":["NOT_CHARGED","SETTLED","UNKNOWN"],"type":"string"},"chargedCredits":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["billingStatus","chargedCredits"]},"items":{"items":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"saveCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"author":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","handle","name","url"]},{"type":"null"}]},"board":{"anyOf":[{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["name","id","url"]},{"type":"null"}]},"images":{"items":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"height":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]},"width":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["url","height","width"]},"type":"array"}},"additionalProperties":false,"type":"object","required":["id","url","title","description","sourceUrl","saveCount","author","board","images"]},"type":"array"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"hasMore":{"type":"boolean"}},"additionalProperties":false,"type":"object","required":["platform","resourceStatus","fetchedAt","sourceFetchedAt","usage","items","nextCursor","hasMore"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"pinterest","resourceStatus":"NOT_FOUND","fetchedAt":"2026-10-28T00:00:00Z","sourceFetchedAt":null,"usage":{"billingStatus":"UNKNOWN","chargedCredits":null},"items":[],"nextCursor":null,"hasMore":false},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/pinterest/pinDetail":{"post":{"operationId":"social_pinterest_pin_detail","x-nexscope-slug":"social-pinterest-pin-detail","summary":"Pinterest Pin","description":"Fetches detailed information about a single Pinterest pin by URL, returning title, description, link, dominantColor, originPinner, pinner, images at multiple resolutions (imageSpec_236x through imageSpec_orig), and pinJoin with visual annotations. Supports a trim option for lighter responses. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Pinterest Pin API View Pricing Get Pinterest pin 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"url":{"type":"string","maxLength":2048,"minLength":1},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"},"cacheMaxAge":{"enum":["1d","3d","7d","14d","30d"],"type":"string"}},"additionalProperties":false,"type":"object","required":["url"]},"example":{"url":"https://www.pinterest.com/pin/123456789/"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"properties":{"platform":{"enum":["instagram","youtube","reddit","pinterest"],"type":"string"},"resourceStatus":{"enum":["AVAILABLE","PARTIAL","PRIVATE","RESTRICTED","NOT_FOUND","NO_TRANSCRIPT","UNKNOWN"],"type":"string"},"fetchedAt":{"format":"date-time","type":"string"},"sourceFetchedAt":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}]},"usage":{"properties":{"billingStatus":{"enum":["NOT_CHARGED","SETTLED","UNKNOWN"],"type":"string"},"chargedCredits":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["billingStatus","chargedCredits"]},"item":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"saveCount":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"author":{"anyOf":[{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","handle","name","url"]},{"type":"null"}]},"board":{"anyOf":[{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["name","id","url"]},{"type":"null"}]},"images":{"items":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"height":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]},"width":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["url","height","width"]},"type":"array"}},"additionalProperties":false,"type":"object","required":["id","url","title","description","sourceUrl","saveCount","author","board","images"]},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["platform","resourceStatus","fetchedAt","sourceFetchedAt","usage","item"]},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"pinterest","resourceStatus":"NOT_FOUND","fetchedAt":"2026-10-28T00:00:00Z","sourceFetchedAt":null,"usage":{"billingStatus":"UNKNOWN","chargedCredits":null},"item":null},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/pinterest/user/boards":{"post":{"operationId":"social_pinterest_user_boards","x-nexscope-slug":"social-pinterest-user-boards","summary":"Pinterest User Boards","description":"Fetches a paginated list of boards for a Pinterest user, returning each board's name, url, description, pin_count, follower_count, owner info, cover_images, and created_at. Supports pagination via cursor and a trim option for lighter responses. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Pinterest User Boards API View Pricing Get a user's boards 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"The username of the user to get boards for. (e.g. broadstbullycom from https://www.pinterest.com/broadstbullycom/)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"broadstbullycom"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"pinterest","data":{"success":true,"boards":[{"id":"549580029467577434","url":"https://www.pinterest.com/sharat24k/turkey-recipes/","description":"","follower_count":292,"pin_count":545,"name":"Turkey Recipes","image_cover_hd_url":"https://i.pinimg.com/474x/45/00/df/4500dfc5bc8bbc15137ff9d9abf04cc1.jpg","created_at":"Mon, 17 Feb 2025 02:19:26 +0000"}],"cursor":"LT41NDk1ODAwMjk0Njc1Njc1O...."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/pinterest/topic":{"post":{"operationId":"social_pinterest_topic","x-nexscope-slug":"social-pinterest-topic","summary":"Pinterest Topic","description":"Retrieves a public Pinterest topic by its ideas URL, returning id, name, url, search_count, updated_at, and refinements in the normal success envelope. search_count is Pinterest's native internal_search_count; its aggregation period is unspecified, so it is not monthly search volume or a unique-person count. updated_at is Pinterest's update_time converted to ISO 8601 UTC, not the separate feed refresh time. search_count is a nonnegative integer and updated_at is a non-null ISO 8601 UTC string on success. Missing or invalid core count or timestamp metadata returns an uncharged 500 failure, not a success with null values. refinements contains the native ideas_klp_pivots chips as label, name, and absolute Pinterest url; [] means explicitly empty, while null means missing or malformed. Related-topic recommendations are not refinement chips. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Pinterest Topic API View Pricing Get a Pinterest topic's search-interest count, last-updated time, and refinement chips from its ideas URL. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The Pinterest ideas URL of the topic to get."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.pinterest.com/ideas/how-to-stop-leash-pulling/894604313079/"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"pinterest","data":{"success":true,"id":"894604313079","name":"how to stop leash pulling","url":"https://www.pinterest.com/ideas/how-to-stop-leash-pulling/894604313079/","search_count":29,"updated_at":"2026-10-28T02:59:50.000Z","refinements":[{"label":"Dog","name":"Dog Leash","url":"https://www.pinterest.com/ideas/dog-leash/920936006020/"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/pinterest/board":{"post":{"operationId":"social_pinterest_board","x-nexscope-slug":"social-pinterest-board","summary":"Pinterest Board","description":"Fetches a paginated list of pins from a Pinterest board by URL, returning each pin's id, description, title, images, board info, pin_join annotations, and aggregated_pin_data. Supports pagination via cursor and a trim option for lighter responses. With trim=true, retains pins[].aggregated_pin_data.aggregated_stats.saves and pins[].pin_join.visual_annotation when Pinterest supplies them; these native save counts and keyword labels are not guaranteed for every pin. Only these nested leaves are retained, not the full aggregated_pin_data or pin_join objects. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Pinterest Board API View Pricing Get pins from a Pinterest board. With trim=true, native save counts and keyword labels are retained when available. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the board to get"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response. Retains pins[].aggregated_pin_data.aggregated_stats.saves and pins[].pin_join.visual_annotation when Pinterest supplies them; these native save counts and keyword labels are not guaranteed for every pin. Only these nested leaves are retained, not the full aggregated_pin_data or pin_join objects."},"cursor":{"type":"string","description":"The cursor to get the next page of results"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.pinterest.com/lizmrodgers/moms-night/"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"pinterest","data":{"success":true,"pins":[{"id":"549579960798399243","link":"https://gekbuzz.com/crispy-air-fryer-pizza-rolls-recipe/","title":"Crispy Air Fryer Pizza Rolls Recipe -","board":{"node_id":"Qm9hcmQ6NTQ5NTgwMDI5NDY3NTc3NDM2","followed_by_me":false,"owner":{"node_id":"VXNlcjo1NDk1ODAwOTgxODYwMzM3MzU=","image_small_url":"https://s.pinimg.com/images/user/default_30.png","is_primary_website_verified":true,"is_verified_merchant":false,"full_name":"Gekbuzz","username":"sharat24k","image_medium_url":"https://s.pinimg.com/images/user/default_75.png","id":"549580098186033735","verified_identity":{}},"privacy":"public","is_collaborative":false,"url":"/sharat24k/pizza-recipes/","layout":"default","type":"board","name":"Pizza Recipes","id":"549580029467577436","collaborated_by_me":false},"unified_user_note":"Craving a quick snack that combines cheesy goodness and crispy texture? These air fryer pizza rolls are the answer! Perfect for movie nights, parties, or just a casual treat, they pack all the flavor of your favorite pizza into a bite-sized delight. Imagine biting into a perfectly golden roll where melty cheese and zesty sauce meld together. The air fryer gives these pizza rolls a satisfying crunch without the extra oil, making them a healthier option that doesn’t skimp on taste.","alt_text":"Crispy air fryer pizza rolls served with marinara sauce for dipping on a plate.","rich_summary":{"actions":[],"products":[],"apple_touch_icon_link":null,"type_name":"article","type":"richpingriddata","id":"5aa12f54bef882f6f3cdd77234027e25","favicon_link":"https://s.pinimg.com/images/default_rich_pin_favicon.png","url":"https://gekbuzz.com/crispy-air-fryer-pizza-rolls-recipe/","display_name":"Crispy Air Fryer Pizza Rolls Recipe -","favicon_images":{"orig":"https://s.pinimg.com/images/default_rich_pin_favicon.png"},"display_description":"Craving a quick snack that combines cheesy goodness and crispy texture? These air fryer pizza rolls are the answer! Perfect for movie nights, parties, or just a casual treat, they pack all the flavor of your favorite pizza into a bite-sized delight. Imagine biting into a perfectly golden roll where melty cheese and zesty sauce […]","apple_touch_icon_images":null,"site_name":"gekbuzz.com"},"reaction_counts":{},"pinner":{"node_id":"VXNlcjo1NDk1ODAwOTgxODYwMzM3MzU=","image_small_url":"https://s.pinimg.com/images/user/default_30.png","is_primary_website_verified":true,"is_verified_merchant":false,"full_name":"Gekbuzz","username":"sharat24k","image_medium_url":"https://s.pinimg.com/images/user/default_75.png","id":"549580098186033735","verified_identity":{}},"description":"Craving a quick snack that combines cheesy goodness and crispy texture? These air fryer pizza rolls are the answer! Perfect for movie nights, parties, or just a casual treat, they pack all the flavor of your favorite pizza into a bite-sized delight. Imagine biting into a perfectly golden roll where melty cheese and zesty sauce meld together. The air fryer gives these pizza rolls a satisfying crunch without the extra oil, making them a healthier option that doesn’t skimp on taste.","domain":"gekbuzz.com"}],"cursor":"Y2JURlEwTVU1RWF6Rk9lbXMxV...."},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/google/search":{"post":{"operationId":"social_google_search","x-nexscope-slug":"social-google-search","summary":"Google Search","description":"Performs a Google search and returns organic results with url, title, and description for each result. Supports an optional region parameter (2-letter country code) to get localized results from a specific country. Pages 1 through 11 are supported; requests for page 12 or greater return a 400 response. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Google Search API View Pricing Search Google 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"region":{"type":"string","description":"2 letter country code, ie US, UK, CA, etc This will show results from that country"},"date_posted":{"type":"string","enum":["last-hour","last-day","last-week","last-month","last-year"],"description":"Date posted"},"page":{"type":"number","description":"Page number to retrieve. Must be between 1 and 11; page 12 or greater returns a 400 response."}},"required":["query"],"additionalProperties":false},"example":{"query":"news"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"google","data":{"success":true,"results":[{"url":"https://x.com/Austen","title":"Austen Allred ✓","description":"Among the dumbest assertions people make online is, “Remote work was better but companies brought everyone back in office to justify the rent they were paying and keep property values high.”  As if companies are incapable of subleasing or selling buildings.    22 hours ago"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/twitch/profile":{"post":{"operationId":"social_twitch_profile","x-nexscope-slug":"social-twitch-profile","summary":"Twitch Profile","description":"Retrieves a Twitch user's public profile by handle, including identity, social links, and content. Returns id, handle, displayName, description, followers count, and linked social accounts (instagram, x, tiktok). Also includes lastBroadcast with startedAt (ISO 8601 UTC) and title, allVideos with game info, duration, and view counts, featuredClips with clip metadata and thumbnails, and similarStreamers. lastBroadcast comes from Twitch's broadcast metadata rather than saved videos, so it can remain available when a channel is offline and its saved broadcasts have expired or were never saved. lastBroadcast is null when Twitch does not provide it; startedAt and title can individually be null when unavailable. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Twitch Profile API View Pricing Get Twitch profile 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Twitch handle"},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"ishowspeed"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"twitch","data":{"success":true,"id":"220476955","isLive":true,"currentViewersCount":6293,"lastBroadcast":{"startedAt":"2026-10-15T20:11:51.586296Z","title":"\uD83D\uDD34LET’S HAVE FUN \uD83E\uDD29 + Speed Vs. Cole Palmer ⚽️\uD83C\uDFF4\uD83E\uDD76"},"handle":"ishowspeed","stream":{},"displayName":"IShowSpeed","profileImageURL":"https://static-cdn.jtvnw.net/jtv_user_pictures/46a38d3a-a39c-4c43-ac12-c331b1c469c2-profile_image-150x150.png","bannerImageURL":"https://static-cdn.jtvnw.net/jtv_user_pictures/983dc814-a78c-4e5a-9d22-e6e7595c76e1-profile_banner-480.png","description":"YouTube:IShowSpeed Instagram:IShowSpeed: Snapchat:wishowspeed Twitter: ishowspeedsui I luv y’all\uD83D\uDC10\uD83D\uDC95","followers":3830874,"isPartner":true,"recentBroadcasts":[{"id":"2761014301","title":"BALLER LEAGUE WEEK 7 ⚽️ SPEED UTD VS FOR THE WIN FC \uD83D\uDD25","previewThumbnailURL":"https://vod-secure.twitch.tv/_404/404_processing_320x180.png","publishedAt":"2026-04-30T21:38:06Z","viewCount":702,"lengthSeconds":13895,"animatedPreviewURL":"https://d2vi6trrdongqn.cloudfront.net/1dfa1f8c049eaa77fe54_ishowspeed_318481977952_1777585080/storyboards/2761014301-strip-0.jpg","resourceRestriction":null,"contentTags":[],"self":{"isRestricted":false,"viewingHistory":null,"__typename":"VideoSelfEdge"},"game":{"id":"423594505","slug":"baller-league","boxArtURL":"https://static-cdn.jtvnw.net/ttv-boxart/423594505-40x56.jpg","displayName":"Baller League","name":"Baller League","__typename":"Game"},"owner":{"id":"220476955","displayName":"IShowSpeed","login":"ishowspeed","profileImageURL":"https://static-cdn.jtvnw.net/jtv_user_pictures/46a38d3a-a39c-4c43-ac12-c331b1c469c2-profile_image-50x50.png","primaryColorHex":"FF4747","__typename":"User"},"__typename":"Video"}],"allVideos":[{"animatedPreviewURL":"https://d2vi6trrdongqn.cloudfront.net/1dfa1f8c049eaa77fe54_ishowspeed_318481977952_1777585080/storyboards/2761014301-strip-0.jpg","game":{"boxArtURL":"https://static-cdn.jtvnw.net/ttv-boxart/423594505-40x56.jpg","id":"423594505","slug":"baller-league","displayName":"Baller League","name":"Baller League","__typename":"Game"},"id":"2761014301","lengthSeconds":13895,"owner":{"displayName":"IShowSpeed","id":"220476955","login":"ishowspeed","profileImageURL":"https://static-cdn.jtvnw.net/jtv_user_pictures/46a38d3a-a39c-4c43-ac12-c331b1c469c2-profile_image-50x50.png","primaryColorHex":"FF4747","roles":{"isPartner":true,"__typename":"UserRoles"},"__typename":"User"},"previewThumbnailURL":"https://vod-secure.twitch.tv/_404/404_processing_320x180.png","publishedAt":"2026-04-30T21:38:06Z","self":{"isRestricted":false,"viewingHistory":null,"__typename":"VideoSelfEdge"},"title":"BALLER LEAGUE WEEK 7 ⚽️ SPEED UTD VS FOR THE WIN FC \uD83D\uDD25","viewCount":702,"resourceRestriction":null,"contentTags":[],"__typename":"Video"}],"similarStreamers":[]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/twitch/user/videos":{"post":{"operationId":"social_twitch_user_videos","x-nexscope-slug":"social-twitch-user-videos","summary":"Twitch User Videos","description":"Fetches a list of videos (100 max) for a Twitch user, returning each video's id, slug, url, embedURL, title, viewCount, language, durationSeconds, game info, broadcaster details with follower count, thumbnailURL, and videoQualities at multiple resolutions with a signed videoURL for playback. Supports pagination via cursor and a trim option for lighter responses. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Twitch User Videos API View Pricing Get Twitch user videos 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Twitch handle"},"filter_by":{"type":"string","enum":["HIGHLIGHT","ARCHIVE","UPLOAD"],"description":"Filter by"},"sort_by":{"type":"string","enum":["TIME","VIEWS"],"description":"Sort by"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"ishowspeed"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"twitch","data":{"success":true,"id":"51496027","isLive":true,"currentViewersCount":2740,"stream":{"id":"319166855259","createdAt":"2026-05-01T16:44:37Z","game":{"id":"21779","displayName":"League of Legends","__typename":"Game"},"type":"live","viewersCount":2740,"__typename":"Stream","tags":[{"id":"fft:CHANNEL:51496027:0","name":"English","__typename":"FreeformTag"}]},"handle":"loltyler1","displayName":"loltyler1","profileImageURL":"https://static-cdn.jtvnw.net/jtv_user_pictures/f3591dbe4ee3d94b-profile_image-150x150.png","bannerImageURL":"https://static-cdn.jtvnw.net/jtv_user_pictures/303b0767-0fb4-4a9f-b8a1-2d8b99f24630-profile_banner-480.png","description":"Season 6 Challenger | Most REFORMED Player NA | #1 Draven World ","followers":5469372,"x":"https://x.com/loltyler1?mx=2","instagram":"https://www.instagram.com/tyler1_alpha/#","youtube":"https://www.youtube.com/channel/UCwV_0HmQkRrTcrReaMxPeDw","tiktok":"https://www.tiktok.com/@loltyler1","isPartner":true,"allVideos":[{"animatedPreviewURL":"https://d1m7jfoe9zdc1j.cloudfront.net/f2ca91ee909630bdb3df_loltyler1_319166855259_1777653877/storyboards/2761630321-strip-0.jpg","game":{"boxArtURL":"https://static-cdn.jtvnw.net/ttv-boxart/21779-40x56.jpg","id":"21779","slug":"league-of-legends","displayName":"League of Legends","name":"League of Legends","__typename":"Game"},"id":"2761630321","lengthSeconds":931,"owner":{"displayName":"loltyler1","id":"51496027","login":"loltyler1","profileImageURL":"https://static-cdn.jtvnw.net/jtv_user_pictures/f3591dbe4ee3d94b-profile_image-50x50.png","primaryColorHex":null,"roles":{"isPartner":true,"__typename":"UserRoles"},"__typename":"User"},"previewThumbnailURL":"https://vod-secure.twitch.tv/_404/404_processing_320x180.png","publishedAt":"2026-05-01T16:44:42Z","self":{"isRestricted":false,"viewingHistory":null,"__typename":"VideoSelfEdge"},"title":"TRY MIGHT ! give NEVER ! BACKS NOT DOWN !! held high for MOMENT WAIT !!! tick ticks ticks ... CLOCK BY PATIENT THIN WAITER !! tick ... NOW !","viewCount":0,"resourceRestriction":null,"contentTags":[],"__typename":"Video"}],"featuredClips":[{"id":"2907296184","slug":"CogentSpeedyWallabyDxCat-nm23_xWWFTxoPI0C","clipTitle":"ewc","clipViewCount":19427,"curator":{"id":"24179021","login":"testrox","displayName":"Testrox","__typename":"User"},"clipGame":{"id":"55453844","slug":"street-fighter-6","name":"Street Fighter 6","displayName":"Street Fighter 6","boxArtURL":"https://static-cdn.jtvnw.net/ttv-boxart/55453844_IGDB-52x72.jpg","__typename":"Game"},"broadcaster":{"id":"51496027","login":"loltyler1","displayName":"loltyler1","profileImageURL":"https://static-cdn.jtvnw.net/jtv_user_pictures/f3591dbe4ee3d94b-profile_image-50x50.png","primaryColorHex":null,"roles":{"isPartner":true,"__typename":"UserRoles"},"__typename":"User"},"thumbnailURL":"https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/53f846ec-21aa-49e4-92e0-3e93b61726f7/landscape/thumb/thumb-0000000000-1920x1080.jpg","createdAt":"2025-07-05T08:09:03Z","durationSeconds":25,"isFeatured":true,"guestStarParticipants":{"host":{"id":"51496027","login":"loltyler1","displayName":"loltyler1","profileImageURL":"https://static-cdn.jtvnw.net/jtv_user_pictures/f3591dbe4ee3d94b-profile_image-300x300.png","primaryColorHex":null,"description":"Season 6 Challenger | Most REFORMED Player NA | #1 Draven World ","__typename":"User"},"guests":[],"sessionIdentifier":"2xmd2itvLAiTeLZsWCYYpifxYv1","__typename":"GuestStarParticipants"},"__typename":"Clip"}],"similarStreamers":[{"id":"459567713","displayName":"SpectateTyler1","login":"spectatetyler1","primaryColorHex":"1F69FF","profileImageURL":"https://static-cdn.jtvnw.net/jtv_user_pictures/184aa4fd-1fd7-42ab-8170-5b98bd2fb37f-profile_image-300x300.png","stream":null,"__typename":"User"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/twitch/user/schedule":{"post":{"operationId":"social_twitch_user_schedule","x-nexscope-slug":"social-twitch-user-schedule","summary":"Twitch User Schedule","description":"Fetches a user's schedule by handle, returning a list of scheduled events with start time, end time, title, description, and thumbnail URL. Supports pagination via cursor and a trim option for lighter responses. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Twitch User Schedule API View Pricing Get Twitch user schedule 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Twitch handle"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"emongg"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"twitch","data":{"success":true,"id":"23220337","primaryColorHex":null,"lastBroadcast":{"id":"318502443360","startedAt":"2026-05-02T08:26:08.899139Z","__typename":"Broadcast"},"broadcastSettings":{"id":"23220337","title":"Checking out Diablo IV: Lord of Hatred! !diablo #DiabloPartner #ad","__typename":"BroadcastSettings"},"stream":{"id":"318502443360","createdAt":"2026-05-02T08:26:00Z","viewersCount":2994,"previewImageURL":"https://static-cdn.jtvnw.net/previews-ttv/live_user_emongg-320x180.jpg","verticalPreviewImageURL":"https://static-cdn.jtvnw.net/previews-ttv/live_user_emongg-180x320.jpg","height":900,"width":1600,"isDualFormat":false,"game":{"id":"515024","slug":"diablo-iv","name":"Diablo IV","__typename":"Game"},"__typename":"Stream"},"videos":{"edges":[{"node":{"id":"2762226372","title":"[!DROPS ENABLED + WINTON BADGE] watching owcs, gaming","createdAt":"2026-05-02T08:26:09Z","lengthSeconds":41352,"viewCount":196,"previewThumbnailURL":"https://vod-secure.twitch.tv/_404/404_processing_320x180.png","game":{"id":"515025","slug":"overwatch-2","name":"Overwatch","__typename":"Game"},"__typename":"Video"},"__typename":"VideoEdge"}],"__typename":"VideoConnection"},"channel":{"id":"23220337","schedule":{"id":"schedule-23220337","nextSegment":{"id":"eyJzZWdtZW50SUQiOiI4ZThhMTczMS1hYjU0LTQxZDMtOTEzMy02N2JjZTM0NTRiMzUiLCJpc29ZZWFyIjoyMDI2LCJpc29XZWVrIjoxOH0=","startAt":"2026-05-03T11:00:00Z","__typename":"ScheduleSegment"},"interruption":null,"segments":[{"id":"eyJzZWdtZW50SUQiOiI5NjU1NWMwMC03OGZkLTQ4NTQtYTIyZS1kYWNjOGU3ZWZlYzkiLCJpc29ZZWFyIjoyMDI2LCJpc29XZWVrIjoxOH0=","baseSegmentID":"96555c00-78fd-4854-a22e-dacc8e7efec9","title":"","startAt":"2026-04-27T11:00:00Z","endAt":"2026-04-27T21:00:00Z","isCancelled":false,"cancelledUntil":null,"hasReminder":false,"repeatEndsAfterCount":null,"categories":[],"__typename":"ScheduleSegment"}],"__typename":"Schedule"},"__typename":"Channel"},"__typename":"User"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/twitch/clip/transcript":{"post":{"operationId":"social_twitch_clip_transcript","x-nexscope-slug":"social-twitch-clip-transcript","summary":"Twitch Clip Transcript","description":"Gets a transcript from a public Twitch clip. Checks native captions first; returned native captions cost 1 credit. Set use_ai_as_fallback=true to opt into paid AI only when captions are unavailable. No transcript costs 0 credits. transcript_source is native, ai, or null. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Twitch Clip Transcript API View Pricing Get native captions from a Twitch clip. Enable use_ai_as_fallback for AI when captions are unavailable. Native captions or AI up to 2 minutes: 1 credit. Paid AI mode: 10 credits/minute, rounded up, even for short videos. No transcript: 0 credits.\nGets a transcript from a public Twitch clip. Checks native captions first; returned native captions cost 1 credit. Set use_ai_as_fallback=true to opt into paid AI only when captions are unavailable. No transcript costs 0 credits. transcript_source is native, ai, or null. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nPaid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nUse paid AI only when native captions are unavailable. Defaults to false. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nCurrent official page: returned native captions or successful default AI up to 120 seconds cost 1; no transcript 0. AI fallback is separately enabled. With literal allow_long_transcription=true, all successful AI, including short, costs 10 per started minute; empty AI/errors have no AI fee.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Twitch clip URL"},"allow_long_transcription":{"type":"boolean","default":false,"description":"Paid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed."},"use_ai_as_fallback":{"type":"boolean","description":"Use paid AI only when native captions are unavailable. Defaults to false. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://clips.twitch.tv/WrongMagnificentTomatoCorgiDerp-C720OEMqocSPbrqA"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"twitch","data":{"success":true,"id":"161412440","url":"https://www.twitch.tv/mish/clip/WrongMagnificentTomatoCorgiDerp-C720OEMqocSPbrqA","transcript":"Gigi's, Gigi's. Oh, it's a spirit. I don't want to play anymore. I should have gone to pee...","transcript_source":"native"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/twitch/clip":{"post":{"operationId":"social_twitch_clip","x-nexscope-slug":"social-twitch-clip","summary":"Twitch Clip","description":"Fetches detailed data for a Twitch clip by URL, including metadata and direct video URLs. Returns clip id, slug, url, embedURL, title, viewCount, language, durationSeconds, game info, broadcaster details with follower count, thumbnailURL, and videoQualities at multiple resolutions with a signed videoURL for playback. Also includes additional clips from the same broadcaster. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Twitch Clip API View Pricing Get Twitch clip 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Twitch clip URL"},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ?filter=clips&range=all&sort=time"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"array"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"twitch","data":[{"data":{"clip":{"id":"387484507","slug":"CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ","url":"https://clips.twitch.tv/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ","embedURL":"https://clips.twitch.tv/embed?clip=CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ","title":"un grande el mesero","viewCount":52441,"language":"ES","isFeatured":true,"assets":[{"id":"AT-cm|W4NkMPhK87GGxO1Fr4AjEA","aspectRatio":1.7777777777777777,"type":"SOURCE","createdAt":"2024-03-30T21:52:12.134391826Z","creationState":"CREATED","curator":{"id":"192477639","login":"satagul_sy","displayName":"Satagul_SY","profileImageURL":"https://static-cdn.jtvnw.net/jtv_user_pictures/a7d1cf0c-6482-475c-a7ba-9fedf75f0149-profile_image-50x50.png","__typename":"User"},"thumbnailURL":"https://clips-media-assets2.twitch.tv/W4NkMPhK87GGxO1Fr4AjEA/AT-cm%7CW4NkMPhK87GGxO1Fr4AjEA-preview-480x272.jpg","videoQualities":[{"frameRate":60.01382974851694,"quality":"1080","sourceURL":"https://production.assets.clips.twitchcdn.net/W4NkMPhK87GGxO1Fr4AjEA/AT-cm%7CW4NkMPhK87GGxO1Fr4AjEA.mp4","__typename":"ClipVideoQuality"}],"portraitMetadata":null,"__typename":"ClipAsset"}],"curator":{"id":"192477639","login":"satagul_sy","displayName":"Satagul_SY","profileImageURL":"https://static-cdn.jtvnw.net/jtv_user_pictures/a7d1cf0c-6482-475c-a7ba-9fedf75f0149-profile_image-70x70.png","__typename":"User"},"game":{"id":"509672","name":"IRL","boxArtURL":"https://static-cdn.jtvnw.net/ttv-boxart/509672-52x72.jpg","displayName":"IRL","slug":"irl","__typename":"Game"},"broadcast":{"id":"43930529883","title":null,"__typename":"Broadcast"},"broadcaster":{"id":"167189231","login":"staryuuki","displayName":"Staryuuki","primaryColorHex":"689AFF","isPartner":true,"profileImageURL":"https://static-cdn.jtvnw.net/jtv_user_pictures/b45a3305-bc42-41cc-a754-e6679a2d9ef0-profile_image-70x70.png","followers":{"totalCount":3450065,"__typename":"FollowerConnection"},"stream":null,"lastBroadcast":{"id":"314597248121","startedAt":"2025-01-23T06:52:10.179125Z","__typename":"Broadcast"},"self":null,"__typename":"User"},"thumbnailURL":"https://clips-media-assets2.twitch.tv/W4NkMPhK87GGxO1Fr4AjEA/AT-cm%7CW4NkMPhK87GGxO1Fr4AjEA-preview-260x147.jpg","createdAt":"2024-03-30T21:52:12Z","isPublished":true,"durationSeconds":27,"champBadge":null,"video":null,"videoOffsetSeconds":null,"videoQualities":[{"sourceURL":"https://production.assets.clips.twitchcdn.net/W4NkMPhK87GGxO1Fr4AjEA/AT-cm%7CW4NkMPhK87GGxO1Fr4AjEA.mp4","__typename":"ClipVideoQuality"}],"isViewerEditRestricted":true,"suggestedCropping":null,"__typename":"Clip","videoURL":"https://production.assets.clips.twitchcdn.net/W4NkMPhK87GGxO1Fr4AjEA/AT-cm%7CW4NkMPhK87GGxO1Fr4AjEA.mp4?sig=43c84d015eddd8ebc145f914824caa1c37ff6559&token=%7B%22authorization%22%3A%7B%22forbidden%22%3Afalse%2C%22reason%22%3A%22%22%7D%2C%22clip_uri%22%3A%22https%3A%2F%2Fproduction.assets.clips.twitchcdn.net%2FW4NkMPhK87GGxO1Fr4AjEA%2FAT-cm%257CW4NkMPhK87GGxO1Fr4AjEA.mp4%22%2C%22clip_slug%22%3A%22CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ%22%2C%22device_id%22%3A%22gtd1TXg9937g0Ra59d6tJBe2f2vWobM7%22%2C%22expires%22%3A1737831991%2C%22user_id%22%3A%22%22%2C%22version%22%3A2%7D"}},"extensions":{"durationMilliseconds":87,"operationName":"ShareClipRenderStatus","requestID":"01JJD92A0J3G5ND9PWV2SSXCPC"}}],"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/apple-music/artist":{"post":{"operationId":"social_apple_music_artist","x-nexscope-slug":"social-apple-music-artist","summary":"Apple Music Artist","description":"Retrieves public Apple Music artist details, including artwork, editorial notes, top songs, albums, music videos, playlists, and related sections. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Apple Music Artist API View Pricing Get Apple Music artist 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Apple Music artist id. If you'd prefer to use the URL instead, you can use the url parameter instead."},"url":{"type":"string","description":"Apple Music artist URL. If you'd prefer to use the id instead, you can use the id parameter instead."}},"required":[],"additionalProperties":false},"example":{"url":"https://music.apple.com/us/artist/taylor-swift/159260351"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"apple-music","data":{"success":true,"data":{"id":"159260351","kind":"artist","name":"Taylor Swift","url":"https://music.apple.com/us/artist/taylor-swift/159260351","artwork":{"url":"https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/70/30/3b/example/1200x1200bb.jpg","width":5998,"height":5998},"editorial_notes":"The country world feigned surprise when Taylor Swift formally embraced pop...","top_songs":[{"id":"1833328840","kind":"song","title":"The Fate of Ophelia","artist_name":"Taylor Swift","url":"https://music.apple.com/us/album/the-fate-of-ophelia/1833328839?i=1833328840","duration_ms":226000}],"albums":[{"id":"1468058165","kind":"album","title":"Lover","subtitle":"Taylor Swift","track_count":18,"url":"https://music.apple.com/us/album/lover/1468058165"}]}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/apple-music/album":{"post":{"operationId":"social_apple_music_album","x-nexscope-slug":"social-apple-music-album","summary":"Apple Music Album","description":"Retrieves public Apple Music album details, including title, artist, artwork, release info, tracks, and more by the artist. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Apple Music Album API View Pricing Get Apple Music album 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Apple Music album id. If you'd prefer to use the URL instead, you can use the url parameter instead."},"url":{"type":"string","description":"Apple Music album URL. If you'd prefer to use the id instead, you can use the id parameter instead."}},"required":[],"additionalProperties":false},"example":{"url":"https://music.apple.com/us/album/lover/1468058165"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"apple-music","data":{"success":true,"data":{"id":"1468058165","kind":"album","title":"Lover","artist_name":"Taylor Swift","artist_url":"https://music.apple.com/us/artist/taylor-swift/159260351","url":"https://music.apple.com/us/album/lover/1468058165","track_count":18,"release_info":"August 23, 2019\n18 songs, 1 hour 1 minute\n℗ 2019 Taylor Swift","tracks":[{"id":"1468058169","kind":"song","title":"I Forgot That You Existed","duration_ms":170651,"track_number":1,"album_id":"1468058165"}]}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/apple-music/track":{"post":{"operationId":"social_apple_music_track","x-nexscope-slug":"social-apple-music-track","summary":"Apple Music Track","description":"Retrieves public Apple Music song details by id or URL. Album track URLs with an i= song id are supported. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Apple Music Track API View Pricing Get Apple Music track 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Apple Music song id. Some songs have standalone song URLs; for album tracks, use the url parameter."},"url":{"type":"string","description":"Apple Music song URL or album track URL."}},"required":[],"additionalProperties":false},"example":{"url":"https://music.apple.com/us/album/lover/1468058165?i=1468058169"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"apple-music","data":{"success":true,"data":{"id":"1468058169","kind":"song","title":"I Forgot That You Existed","album":null,"url":"https://music.apple.com/us/album/i-forgot-that-you-existed/1468058165?i=1468058169","duration_ms":170651,"track_number":1,"artist_name":null,"explicit":false}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/apple-music/search":{"post":{"operationId":"social_apple_music_search","x-nexscope-slug":"social-apple-music-search","summary":"Apple Music Search","description":"Searches Apple Music and returns public result sections for artists, albums, songs, playlists, stations, and music videos. Use type=song, album, artist, playlist, or all. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Apple Music Search API View Pricing Search Apple Music 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"type":{"type":"string","description":"Result type to return. Use all, song, album, artist, playlist, station, music_video, or radio_episode."}},"required":["query"],"additionalProperties":false},"example":{"query":"taylor swift"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"apple-music","data":{"success":true,"data":{"query":"taylor swift","type":"song","results":[{"id":"1833328840","kind":"song","title":"The Fate of Ophelia","artist_name":"Taylor Swift","url":"https://music.apple.com/us/album/the-fate-of-ophelia/1833328839?i=1833328840","duration_ms":226000}]}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/spotify/artist":{"post":{"operationId":"social_spotify_artist","x-nexscope-slug":"social-spotify-artist","summary":"Spotify Artist","description":"Retrieves detailed information about a Spotify artist by their handle, including name, followers count, genres, and related artists. Accepts a handle as input and returns artist metadata such as id, name, followers, genres, and related artists. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Spotify Artist API View Pricing Get Spotify artist 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Spotify artist id. If you'd prefer to use the URL instead, you can use the url parameter instead."},"url":{"type":"string","description":"Spotify artist URL. If you'd prefer to use the id instead, you can use the id parameter instead."}},"required":[],"additionalProperties":false},"example":{"url":"https://open.spotify.com/artist/0cGUm45nv7Z6M6qdXYQGTX"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"spotify","data":{"success":true,"__typename":"Artist","discography":{"albums":[{"copyright":[{"text":"© 2026 Atlantic Records Group LLC","type":"C"}],"coverArt":{"sources":[{"height":300,"url":"https://i.scdn.co/image/ab67616d00001e02d4ffe3d4cddee37b9fd6ffcd","width":300}]},"date":{"day":24,"month":4,"precision":"DAY","year":2026},"id":"2xkYTmqjear3lSGydIn7wh","label":"TSNMI / Atlantic","name":"Kehlani","playability":{"playable":true,"reason":"PLAYABLE"},"sharingInfo":{"shareId":"U8dlM5bqR9-6k0v2R2AZXA","shareUrl":"https://open.spotify.com/album/2xkYTmqjear3lSGydIn7wh?si=U8dlM5bqR9-6k0v2R2AZXA"},"tracks":{"totalCount":17},"type":"ALBUM","uri":"spotify:album:2xkYTmqjear3lSGydIn7wh"}],"compilations":[],"latest":{"copyright":[{"text":"© 2026 Atlantic Records Group LLC","type":"C"}],"coverArt":{"sources":[{"height":300,"url":"https://i.scdn.co/image/ab67616d00001e02d4ffe3d4cddee37b9fd6ffcd","width":300}]},"date":{"day":24,"month":4,"precision":"DAY","year":2026},"id":"2xkYTmqjear3lSGydIn7wh","label":"TSNMI / Atlantic","name":"Kehlani","playability":{"playable":true,"reason":"PLAYABLE"},"sharingInfo":{"shareId":"T_Af2soBSuGDSt2oVHDtKg","shareUrl":"https://open.spotify.com/album/2xkYTmqjear3lSGydIn7wh?si=T_Af2soBSuGDSt2oVHDtKg"},"tracks":{"totalCount":17},"type":"ALBUM","uri":"spotify:album:2xkYTmqjear3lSGydIn7wh"},"popularReleasesAlbums":[{"copyright":[{"text":"© 2026 Atlantic Records Group LLC","type":"C"}],"coverArt":{"sources":[{"height":300,"url":"https://i.scdn.co/image/ab67616d00001e02d4ffe3d4cddee37b9fd6ffcd","width":300}]},"date":{"day":24,"month":4,"precision":"DAY","year":2026},"id":"2xkYTmqjear3lSGydIn7wh","label":"TSNMI / Atlantic","name":"Kehlani","playability":{"playable":true,"reason":"PLAYABLE"},"sharingInfo":{"shareId":"9oSy6lB1SlqNi7vkqsNWeQ","shareUrl":"https://open.spotify.com/album/2xkYTmqjear3lSGydIn7wh?si=9oSy6lB1SlqNi7vkqsNWeQ"},"tracks":{"totalCount":17},"type":"ALBUM","uri":"spotify:album:2xkYTmqjear3lSGydIn7wh"}],"singles":[{"copyright":[{"text":"© 2026 Atlantic Records Group LLC","type":"C"}],"coverArt":{"sources":[{"height":300,"url":"https://i.scdn.co/image/ab67616d00001e02b12f0dbd960ab2e252b64a95","width":300}]},"date":{"day":23,"month":4,"precision":"DAY","year":2026},"id":"4OIEqxUAhJ3fxEVqf5L9GB","label":"TSNMI / Atlantic","name":"Sweet Nuthins (feat. Leon Thomas)","playability":{"playable":true,"reason":"PLAYABLE"},"sharingInfo":{"shareId":"PpIIKS6USVmF7q85N6prqw","shareUrl":"https://open.spotify.com/album/4OIEqxUAhJ3fxEVqf5L9GB?si=PpIIKS6USVmF7q85N6prqw"},"tracks":{"totalCount":1},"type":"SINGLE","uri":"spotify:album:4OIEqxUAhJ3fxEVqf5L9GB"}],"topTracks":[{"track":{"albumOfTrack":{"coverArt":{"sources":[{"url":"https://i.scdn.co/image/ab67616d00001e02d9233d03f5434d9dd46c9fd6"}]},"uri":"spotify:album:5KS0QmxwUmSPsolg9VaSAU"},"artists":[{"profile":{"name":"Kehlani"},"uri":"spotify:artist:0cGUm45nv7Z6M6qdXYQGTX"}],"associationsV3":{"videoAssociations":{"totalCount":1}},"contentRating":{"label":"NONE"},"discNumber":1,"duration":{"totalMilliseconds":237928},"id":"6sTlzpJaFGkFQ4BNccmbW9","name":"Folded","playability":{"playable":true,"reason":"PLAYABLE"},"playcount":493498588,"uri":"spotify:track:6sTlzpJaFGkFQ4BNccmbW9","popularity":79},"uid":"a838730591ee5251ecfd"}]},"goods":{"concerts":[{"__typename":"ConcertV2","festival":false,"location":{"city":"Las Vegas","name":"LIV Nightclub Las Vegas"},"startDateIsoString":"2026-06-19T22:30-07:00","title":"Kehlani","uri":"spotify:concert:4Qygm81hJ84WfQdINSGPp2"}],"merch":[]},"headerImage":{"__typename":"ImageV2","sources":[{"maxHeight":640,"maxWidth":1494,"url":"https://image-cdn-fa.spotifycdn.com/image/ab676186000001945388724675d387b1c00995c0"}]},"id":"0cGUm45nv7Z6M6qdXYQGTX","onPlatformReputationTrait":{"verification":{"isRegistered":true,"isVerified":true}},"preRelease":null,"profile":{"biography":{"text":"Without sugarcoating or softening a word, the Bay Area-born two-time GRAMMY® Award-nominated multiplatinum songstress will drop a hard truth in one breath and flip a middle finger in the next. Either way, she finds a way to consistently relate without filter. Kehlani’s 2015 breakout mixtape You Should Be Here received a GRAMMY® nod in the category of “Best Urban Contemporary Album.” She contributed to the soundtracks for Suicide Squad and The Fate of the Furious and guested on Cardi B’s “Ring,” Kyle’s “PLAYINWITME,” and Justin Bieber’s “Get Me,” to name a few. By 2020, she picked up three gold solo singles—&quot;You Should Be Here,” “Honey,” and “Distraction,” for which she received her second GRAMMY® nomination for Best R&amp;B performance. In addition, four platinum singles—“Gangsta,” “The Way” [feat. Chance the Rapper], “CRZY,” and “Nights Like This” [feat. Ty Dolla $ign] and streams in the billions. Not to mention, Billboard Women In Music honored her with the “Rule Breaker Award”.  In the aftermath of 2019’s chart-topping While We Wait mixtape, everything changed. She became a mom. As such, parenthood left an indelible imprint on her second full-length, It Was Good Until It Wasn’t. The album is described by Kehlani as her most mature body of work, featuring songs based on her own real experiences including “Toxic” and “Everybody Business.” In the end, you’ll know exactly what’s on Kehlani’s mind, heart, and soul.","type":"AUTOBIOGRAPHY"},"externalLinks":[{"name":"FACEBOOK","url":"https://facebook.com/Kehlanimusic"}],"name":"Kehlani","pinnedItem":{"backgroundImageV2":{"__typename":"ImageV2","sources":[{"url":"https://image-cdn-fa.spotifycdn.com/image/ab6761700000591033fb379e5ab59969bd6dfd0b"}]},"comment":"New Kehlani album is out now! ","itemV2":{"__typename":"AlbumResponseWrapper","data":{"__typename":"Album","coverArt":{"sources":[{"height":300,"url":"https://i.scdn.co/image/ab67616d00001e02d4ffe3d4cddee37b9fd6ffcd","width":300}]},"name":"Kehlani","preReleaseEndDateTime":{"isoString":"2026-04-24T04:00:00Z"},"type":"ALBUM","uri":"spotify:album:2xkYTmqjear3lSGydIn7wh"}},"subtitle":"Album • New Release","thumbnailImage":{"sources":[{"url":"https://image-cdn-ak.spotifycdn.com/image/ab67616d000075a0d4ffe3d4cddee37b9fd6ffcd"}]},"title":"Kehlani","type":"ALBUM","uri":"spotify:album:2xkYTmqjear3lSGydIn7wh"},"playlistsV2":[{"__typename":"Playlist","description":"Kehlani the album, out now  \uD83E\uDEC0!  Tap the ⨁ to be the first to hear new Kehlani songs as soon as they're released.","images":[{"sources":[{"height":null,"url":"https://image-cdn-ak.spotifycdn.com/image/ab67706c0000d72c4ab1888352d5c1333ee7acfb","width":null}]}],"name":"Kehlani - Kehlani","ownerV2":{"__typename":"User","name":"Topsify Radio"},"uri":"spotify:playlist:5dQQwjCOKTSK69NFkwnqeT"}]},"relatedContent":{"appearsOn":[{"artists":[{"profile":{"name":"Post Malone"},"uri":"spotify:artist:246dkjvS1zLTtiykXe5h60"}],"coverArt":{"sources":[{"height":300,"url":"https://i.scdn.co/image/ab67616d00001e0255404f712deb84d0650a4b41","width":300}]},"date":{"year":2016},"id":"5s0rmjP8XOPhP6HhqOhuyC","name":"Stoney (Deluxe)","sharingInfo":{"shareId":"Akg8JnIwT8aiRr33zjf_kQ","shareUrl":"https://open.spotify.com/album/5s0rmjP8XOPhP6HhqOhuyC?si=Akg8JnIwT8aiRr33zjf_kQ"},"type":"ALBUM","uri":"spotify:album:5s0rmjP8XOPhP6HhqOhuyC"}],"discoveredOnV2":[{"__typename":"GenericError"}],"featuringV2":[{"__typename":"Playlist","description":"This is Kehlani. The essential tracks, all in one playlist.","id":"37i9dQZF1DZ06evO039Pyg","images":[{"sources":[{"height":null,"url":"https://pickasso.spotifycdn.com/image/ab67c0de0000deef/dt/v1/img/thisisv3/0cGUm45nv7Z6M6qdXYQGTX/en","width":null}]}],"name":"This Is Kehlani","ownerV2":{"__typename":"User","name":"Spotify"},"uri":"spotify:playlist:37i9dQZF1DZ06evO039Pyg"}],"relatedArtists":[{"id":"7HkdQ0gt53LP4zmHsL0nap","profile":{"name":"Ella Mai"},"uri":"spotify:artist:7HkdQ0gt53LP4zmHsL0nap","visuals":{"avatarImage":{"sources":[{"height":640,"url":"https://i.scdn.co/image/ab6761610000e5eb5d6ed813fc2c93765152ff7e","width":640}]}}}]},"relatedMusicVideos":[],"saved":false,"sharingInfo":{"shareId":"XG-mh-ZuSdK7Cl_zcnEAQA","shareUrl":"https://open.spotify.com/artist/0cGUm45nv7Z6M6qdXYQGTX?si=XG-mh-ZuSdK7Cl_zcnEAQA"},"stats":{"followers":9462413,"monthlyListeners":28333760,"topCities":[{"city":"London","country":"GB","numberOfListeners":518632,"region":"ENG"}],"worldRank":256},"unmappedMusicVideos":[],"uri":"spotify:artist:0cGUm45nv7Z6M6qdXYQGTX","watchFeedEntrypoint":null,"popularity":79},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/spotify/track":{"post":{"operationId":"social_spotify_track","x-nexscope-slug":"social-spotify-track","summary":"Spotify Track","description":"Retrieves detailed information about a Spotify track by its id or URL, including track metadata, artists, album info, duration, playability, and sharing details. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Spotify Track API View Pricing Get Spotify track 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Spotify track id. If you'd prefer to use the URL instead, you can use the url parameter instead."},"url":{"type":"string","description":"Spotify song URL. If you'd prefer to use the id instead, you can use the id parameter instead."}},"required":[],"additionalProperties":false},"example":{"url":"https://open.spotify.com/track/1ITJflybJsfarsUtiBvkfK"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"spotify","data":{"success":true,"popularity":75,"__typename":"Track","associationsV3":{"audioAssociations":[],"videoAssociations":{"totalCount":0}},"contentRating":{"label":"EXPLICIT"},"duration":{"totalMilliseconds":186112},"id":"1ITJflybJsfarsUtiBvkfK","mediaType":"AUDIO","name":"Shoulda Never (feat. USHER)","playability":{"playable":true,"reason":"PLAYABLE"},"playcount":7190090,"saved":false,"sharingInfo":{"shareId":"uSMzDZBBRDOHdFcn87thNw","shareUrl":"https://open.spotify.com/track/1ITJflybJsfarsUtiBvkfK?si=uSMzDZBBRDOHdFcn87thNw"},"trackNumber":8,"uri":"spotify:track:1ITJflybJsfarsUtiBvkfK","albumOfTrack":{"copyright":[{"text":"© 2026 Atlantic Records Group LLC","type":"C"}],"courtesyLine":"","id":"2xkYTmqjear3lSGydIn7wh","date":{"isoString":"2026-04-24T00:00:00Z","precision":"DAY","year":2026},"name":"Kehlani","playability":{"playable":true},"sharingInfo":{"shareId":"tgjmwiVTRmaaQGK0sKdcJg","shareUrl":"https://open.spotify.com/album/2xkYTmqjear3lSGydIn7wh?si=tgjmwiVTRmaaQGK0sKdcJg"},"tracks":[{"track":{"trackNumber":1,"uri":"spotify:track:4PDLyPnlDeu7PRzAUyyUO3"}}],"type":"ALBUM","uri":"spotify:album:2xkYTmqjear3lSGydIn7wh","coverArt":{"extractedColors":{"colorRaw":{"hex":"#502020"}},"sources":[{"height":300,"url":"https://i.scdn.co/image/ab67616d00001e02d4ffe3d4cddee37b9fd6ffcd","width":300}]}},"firstArtist":[{"discography":{"albums":[{"date":{"isoString":"2026-04-24T00:00:00Z","precision":"DAY","year":2026},"name":"Kehlani","playability":{"playable":true},"sharingInfo":{"shareId":"o2YeInVoTnSojn2WeDO3JQ","shareUrl":"https://open.spotify.com/album/2xkYTmqjear3lSGydIn7wh?si=o2YeInVoTnSojn2WeDO3JQ"},"tracks":[{"track":{"trackNumber":1,"uri":"spotify:track:4PDLyPnlDeu7PRzAUyyUO3"}}],"type":"ALBUM","uri":"spotify:album:2xkYTmqjear3lSGydIn7wh","coverArt":{"extractedColors":{"colorRaw":{"hex":"#502020"}},"sources":[{"height":300,"url":"https://i.scdn.co/image/ab67616d00001e02d4ffe3d4cddee37b9fd6ffcd","width":300}]}}],"popularReleasesAlbums":[{"date":{"isoString":"2026-04-24T00:00:00Z","precision":"DAY","year":2026},"name":"Kehlani","playability":{"playable":true},"sharingInfo":{"shareId":"kDxxO1hmRp2Bpu66R81Ujw","shareUrl":"https://open.spotify.com/album/2xkYTmqjear3lSGydIn7wh?si=kDxxO1hmRp2Bpu66R81Ujw"},"tracks":[{"track":{"trackNumber":1,"uri":"spotify:track:4PDLyPnlDeu7PRzAUyyUO3"}}],"type":"ALBUM","uri":"spotify:album:2xkYTmqjear3lSGydIn7wh","coverArt":{"extractedColors":{"colorRaw":{"hex":"#502020"}},"sources":[{"height":300,"url":"https://i.scdn.co/image/ab67616d00001e02d4ffe3d4cddee37b9fd6ffcd","width":300}]}}],"singles":[{"date":{"isoString":"2026-04-23T00:00:00Z","precision":"DAY","year":2026},"name":"Sweet Nuthins (feat. Leon Thomas)","playability":{"playable":true},"sharingInfo":{"shareId":"YbH9FRW_RCKl62VAEMgVhA","shareUrl":"https://open.spotify.com/album/4OIEqxUAhJ3fxEVqf5L9GB?si=YbH9FRW_RCKl62VAEMgVhA"},"tracks":[{"track":{"trackNumber":1,"uri":"spotify:track:7qa1DytPRohFzfOarz6orJ"}}],"type":"SINGLE","uri":"spotify:album:4OIEqxUAhJ3fxEVqf5L9GB","coverArt":{"extractedColors":{"colorRaw":{"hex":"#502020"}},"sources":[{"height":300,"url":"https://i.scdn.co/image/ab67616d00001e02b12f0dbd960ab2e252b64a95","width":300}]}}],"topTracks":[{"track":{"albumOfTrack":{"name":"Kehlani","uri":"spotify:album:5KS0QmxwUmSPsolg9VaSAU","coverArt":{"extractedColors":{},"sources":[]}},"artists":[{"profile":{},"uri":"spotify:artist:0cGUm45nv7Z6M6qdXYQGTX"}],"associationsV3":{"audioAssociations":[],"videoAssociations":{"totalCount":1}},"contentRating":{"label":"NONE"},"duration":{"totalMilliseconds":237928},"id":"6sTlzpJaFGkFQ4BNccmbW9","name":"Folded","playability":{"playable":true},"playcount":469410555,"previews":{"audioPreviews":[{}]},"uri":"spotify:track:6sTlzpJaFGkFQ4BNccmbW9"}}]},"id":"0cGUm45nv7Z6M6qdXYQGTX","profile":{"name":"Kehlani"},"relatedContent":{"relatedArtists":[{"id":"7HkdQ0gt53LP4zmHsL0nap","profile":{"name":"Ella Mai"},"uri":"spotify:artist:7HkdQ0gt53LP4zmHsL0nap","visuals":{"avatarImage":{"sources":[{}]}}}]},"uri":"spotify:artist:0cGUm45nv7Z6M6qdXYQGTX","visuals":{"avatarImage":{"sources":[{"height":640,"url":"https://i.scdn.co/image/ab6761610000e5ebcf865d7d399a41e1bd036149","width":640}]}}}],"otherArtists":[{"discography":{"popularReleasesAlbums":[{"coverArt":{"extractedColors":{"colorRaw":{"hex":"#404030"}},"sources":[{"height":300,"url":"https://i.scdn.co/image/ab67616d00001e02365b3fb800c19f7ff72602da","width":300}]},"date":{"isoString":"2004-03-23T00:00:00Z","precision":"DAY","year":2004},"name":"Confessions (Expanded Edition)","playability":{"playable":true},"sharingInfo":{"shareId":"pCyjyjRLTMCCoMKOe1QAHg","shareUrl":"https://open.spotify.com/album/1RM6MGv6bcl6NrAG8PGoZk?si=pCyjyjRLTMCCoMKOe1QAHg"},"tracks":[{"track":{"trackNumber":1,"uri":"spotify:track:1tV1G9juUCSNEDdVhCaWKh"}}],"type":"ALBUM","uri":"spotify:album:1RM6MGv6bcl6NrAG8PGoZk"}]},"id":"23zg3TcAtWQy7J6upgbUnj","profile":{"name":"USHER"},"uri":"spotify:artist:23zg3TcAtWQy7J6upgbUnj","visuals":{"avatarImage":{"sources":[{"height":640,"url":"https://i.scdn.co/image/ab6761610000e5ebb13684907cd609d10d41f0b8","width":640}]}}}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/spotify/album":{"post":{"operationId":"social_spotify_album","x-nexscope-slug":"social-spotify-album","summary":"Spotify Album","description":"Retrieves detailed information about a Spotify album by its id or URL, including album metadata, artists, release date, cover art, copyright info, tracks, and sharing details. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Spotify Album API View Pricing Get Spotify album 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Spotify album id. If you'd prefer to use the URL instead, you can use the url parameter instead."},"url":{"type":"string","description":"Spotify album URL. If you'd prefer to use the id instead, you can use the id parameter instead."}},"required":[],"additionalProperties":false},"example":{"url":"https://open.spotify.com/album/0pgrg7phBbnwGJ2HBEl9EG"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"spotify","data":{"success":true,"popularity":14,"id":"0pgrg7phBbnwGJ2HBEl9EG","uri":"spotify:album:0pgrg7phBbnwGJ2HBEl9EG","__typename":"Album","copyright":[{"text":"2025 IRL Angel","type":"C"}],"courtesyLine":"","date":{"isoString":"2025-03-16T00:00:00Z","precision":"DAY"},"isPreRelease":false,"label":"IRL Angel","name":"BEFORE THE SUN RISES & WINTERR ENDS","playability":{"playable":true,"reason":"PLAYABLE"},"preReleaseEndDateTime":null,"saved":false,"sharingInfo":{"shareId":"mULFEWCzRY2MmJMhNahQMA","shareUrl":"https://open.spotify.com/album/0pgrg7phBbnwGJ2HBEl9EG?si=mULFEWCzRY2MmJMhNahQMA"},"tracksV2":[{"track":{"artists":[{"profile":{"name":"Miguel Angeles"},"uri":"spotify:artist:14xRX3JR8H4RWh8R7V3fvZ"}],"associationsV3":{"videoAssociations":{"totalCount":0}},"contentRating":{"label":"NONE"},"discNumber":1,"duration":{"totalMilliseconds":184109},"name":"AN IMPERRFECT BODY","playability":{"playable":true},"playcount":130437,"relinkingInformation":null,"saved":false,"trackNumber":1,"uri":"spotify:track:0LfCnR4s7l6T4TyCNNsHBs"},"uid":"0c86f1002074d296d295"}],"type":"SINGLE","visualIdentity":{"squareCoverImage":{"__typename":"VisualIdentityImage","extractedColorSet":{"encoreBaseSetTextColor":{"alpha":255,"blue":224,"green":224,"red":224},"highContrast":{"backgroundBase":{"alpha":255,"blue":83,"green":83,"red":83},"backgroundTintedBase":{"alpha":255,"blue":51,"green":51,"red":51},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"higherContrast":{"backgroundBase":{"alpha":255,"blue":53,"green":53,"red":53},"backgroundTintedBase":{"alpha":255,"blue":86,"green":86,"red":86},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":96,"green":215,"red":30},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"minContrast":{"backgroundBase":{"alpha":255,"blue":153,"green":153,"red":153},"backgroundTintedBase":{"alpha":255,"blue":128,"green":128,"red":128},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":255,"green":255,"red":255}}}}},"watchFeedEntrypoint":null,"artists":[{"id":"14xRX3JR8H4RWh8R7V3fvZ","profile":{"name":"Miguel Angeles"},"sharingInfo":{"shareUrl":"https://open.spotify.com/artist/14xRX3JR8H4RWh8R7V3fvZ?si=LfcPfGMFQB-_Gpvc-_mIXA"},"uri":"spotify:artist:14xRX3JR8H4RWh8R7V3fvZ","visuals":{"avatarImage":{"sources":[{"height":640,"url":"https://i.scdn.co/image/ab6761610000e5eb9784901e4c2fb5e2e59bf7b2","width":640}]}}}],"coverArt":{"extractedColors":{"colorDark":{"hex":"#777777"},"colorLight":{"hex":"#E0E0E0"},"colorRaw":{"hex":"#E0E0E0"}},"sources":[{"height":300,"url":"https://i.scdn.co/image/ab67616d00001e029bd93cc6e406b820dfff691f","width":300}]},"discs":[{"number":1,"tracks":{"totalCount":3}}],"releases":[],"moreAlbumsByArtist":[{"discography":{"popularReleasesAlbums":[{"coverArt":{"sources":[{"height":300,"url":"https://i.scdn.co/image/ab67616d00001e02e1b81322a76efedc9296226b","width":300}]},"date":{"year":2023},"id":"73WPr90gWBdNLg1KHkgpc0","name":"PROTECTION CHARM (SLOW & HARD VERSION)","playability":{"playable":true,"reason":"PLAYABLE"},"sharingInfo":{"shareId":"0oYuiIkGSle7UN5bTeILnw","shareUrl":"https://open.spotify.com/album/73WPr90gWBdNLg1KHkgpc0?si=0oYuiIkGSle7UN5bTeILnw"},"type":"SINGLE","uri":"spotify:album:73WPr90gWBdNLg1KHkgpc0"}]}}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/spotify/playlist":{"post":{"operationId":"social_spotify_playlist","x-nexscope-slug":"social-spotify-playlist","summary":"Spotify Playlist","description":"Retrieves public Spotify playlist metadata and up to 50 tracks by playlist id or URL. For playlists with more tracks, pass the returned cursor into the next request until cursor is null. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Spotify Playlist API View Pricing Get a Spotify playlist and its tracks 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Spotify playlist id. If you'd prefer to use the URL instead, you can use the url parameter instead."},"url":{"type":"string","description":"Spotify playlist URL. If you'd prefer to use the id instead, you can use the id parameter instead."},"cursor":{"type":"string","description":"Cursor returned by the previous response. Omit it for the first page."}},"required":[],"additionalProperties":false},"example":{"url":"https://open.spotify.com/playlist/37i9dQZF1DX4UtSsGT1Sbe"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"spotify","data":{"success":true,"id":"37i9dQZF1DX4UtSsGT1Sbe","uri":"spotify:playlist:37i9dQZF1DX4UtSsGT1Sbe","__typename":"Playlist","description":"The biggest songs of the 1980s. Cover: Madonna","followers":12016730,"images":[{"sources":[{"height":null,"url":"https://i.scdn.co/image/ab67706f00000002fb8e01f2c022ab1a32e2c5a0","width":null}]}],"name":"All Out 80s","ownerV2":{"__typename":"User","name":"Spotify","uri":"spotify:user:spotify","username":"spotify"},"tracks":[{"id":"6r8k1vznHrzlEKYxL4dZEe","uri":"spotify:track:6r8k1vznHrzlEKYxL4dZEe","name":"La Isla Bonita","albumOfTrack":{"name":"True Blue","uri":"spotify:album:6fmnT17jc2Sc69q3nza1eD"},"artists":[{"profile":{"name":"Madonna"},"uri":"spotify:artist:6tbjWDEIzxoDsBA1FuhfPW"}],"duration":{"totalMilliseconds":242733},"playcount":785646615}],"cursor":50,"totalCount":150},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/spotify/search":{"post":{"operationId":"social_spotify_search","x-nexscope-slug":"social-spotify-search","summary":"Spotify Search","description":"Search Spotify for tracks, artists, albums, episodes, podcasts, and audiobooks. Use type=podcasts when you need podcast ids for the podcast endpoints. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Spotify Search API View Pricing Search Spotify 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"}},"required":["query"],"additionalProperties":false},"example":{"query":"my first million"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"spotify","data":{"success":true,"albumsV2":[{"id":"3Pceq8de2pHC1rddG2G88l","__typename":"Album","artists":[{"profile":{"name":"The Antediluvian"},"uri":"spotify:artist:1expE9R1GqL3lGGh5HDH8t"}],"coverArt":{"extractedColors":{"colorDark":{"hex":"#535353","isFallback":true}},"sources":[{"height":300,"url":"https://i.scdn.co/image/ab67616d00001e0230562d52a17a5892eb0958d7","width":300}]},"date":{"year":2026},"isAlbumPreRelease":false,"name":"My First Million (Jesse Livermore Story / Stock Operator Soundtrack)","playability":{"playable":true,"reason":"PLAYABLE"},"preReleaseEndDateTime":null,"type":"SINGLE","uri":"spotify:album:3Pceq8de2pHC1rddG2G88l","visualIdentity":{"squareCoverImage":{"__typename":"VisualIdentityImage","extractedColorSet":{"encoreBaseSetTextColor":{"alpha":255,"blue":187,"green":187,"red":187},"highContrast":{"backgroundBase":{"alpha":255,"blue":83,"green":83,"red":83},"backgroundTintedBase":{"alpha":255,"blue":51,"green":51,"red":51},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"higherContrast":{"backgroundBase":{"alpha":255,"blue":53,"green":53,"red":53},"backgroundTintedBase":{"alpha":255,"blue":86,"green":86,"red":86},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":96,"green":215,"red":30},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"minContrast":{"backgroundBase":{"alpha":255,"blue":83,"green":83,"red":83},"backgroundTintedBase":{"alpha":255,"blue":51,"green":51,"red":51},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":255,"green":255,"red":255}}}}}}],"artists":[{"id":"1QsfhlGvu9tLL2PSmEr8TM","__typename":"Artist","onPlatformReputationTrait":{"verification":{"isVerified":true}},"profile":{"name":"Small Million"},"uri":"spotify:artist:1QsfhlGvu9tLL2PSmEr8TM","visualIdentity":{"squareCoverImage":{"__typename":"VisualIdentityImage","extractedColorSet":{"encoreBaseSetTextColor":{"alpha":255,"blue":209,"green":183,"red":191},"highContrast":{"backgroundBase":{"alpha":255,"blue":102,"green":80,"red":87},"backgroundTintedBase":{"alpha":255,"blue":68,"green":47,"red":55},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":228,"green":201,"red":210}},"higherContrast":{"backgroundBase":{"alpha":255,"blue":71,"green":50,"red":57},"backgroundTintedBase":{"alpha":255,"blue":105,"green":82,"red":90},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":96,"green":215,"red":30},"textSubdued":{"alpha":255,"blue":228,"green":201,"red":210}},"minContrast":{"backgroundBase":{"alpha":255,"blue":136,"green":112,"red":120},"backgroundTintedBase":{"alpha":255,"blue":108,"green":85,"red":92},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":255,"green":255,"red":255}}}}},"visuals":{"avatarImage":{"extractedColors":{"colorDark":{"hex":"#787088","isFallback":false}},"sources":[{"height":640,"url":"https://i.scdn.co/image/ab6761610000e5eb58f2728543287fcbd8de3e4c","width":640}]}}}],"audiobooks":[{"id":"3CuDAyUZ9XSAXKAYmk7jEu","__typename":"Audiobook","accessInfo":{"accessExplanation":{"__typename":"EngagementAccessExplanation"},"isUserMemberOfAtLeastOneGroup":false,"signifier":{"text":""}},"authorsV2":[{"name":"Steven Bartlett","uri":"spotify:author:3McnkRBnDLs8VUFMjilc2N"}],"coverArt":{"extractedColors":{"colorDark":{"hex":"#404040","isFallback":false}},"sources":[{"height":64,"url":"https://i.scdn.co/image/ab6766630000703b2f6a96457fa76c06b435fd50","width":64}]},"description":"Author(s): Steven Bartlett\nNarrator(s): Steven Bartlett\n\nA galvanizing playbook for success from Steven Bartlett, one of the world’s most exciting entrepreneurs and the host of the No. 1 podcast The Diary of a CEO\"This is a must-read for anyone dreaming of doing something audacious.\" Jay Shetty\"Valuable lessons about the importance of following a different and unconventional path to power.” Robert GreeneAt the very heart of all the success and failure I've been exposed to - both my own entrepreneurial journey and through the thousands of interviews I’ve conducted on my chart-topping podcast - are a set of principles that ensure excellence.These fundamental laws underpinned my meteoric rise, and they will fuel yours too, whether you want to build something great or become someone great. The laws are rooted in psychology and behavioral science, in my own experiences, and those of the world's most successful entrepreneurs, entertainers, artists, writers, and athletes, who I’ve interviewed on my podcast.These laws will stand the test of time and will help anyone master their life and unleash their potential, no matter the field.They are the secret sauce to success.","audiobookDuration":{"totalMilliseconds":24291148},"isPreRelease":false,"mediaType":"AUDIO","name":"The Diary of a CEO: The 33 Laws of Business and Life","preReleaseEndDateTime":{"isoString":"2025-11-11T08:00:00Z"},"publishDate":{"isoString":"2023-08-29T00:00:00Z","precision":"MINUTE"},"topics":[],"uri":"spotify:show:3CuDAyUZ9XSAXKAYmk7jEu","visualIdentity":{"squareCoverImage":{"__typename":"VisualIdentityImage","extractedColorSet":{"encoreBaseSetTextColor":{"alpha":255,"blue":187,"green":187,"red":187},"highContrast":{"backgroundBase":{"alpha":255,"blue":64,"green":64,"red":64},"backgroundTintedBase":{"alpha":255,"blue":94,"green":94,"red":94},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"higherContrast":{"backgroundBase":{"alpha":255,"blue":53,"green":53,"red":53},"backgroundTintedBase":{"alpha":255,"blue":86,"green":86,"red":86},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":96,"green":215,"red":30},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"minContrast":{"backgroundBase":{"alpha":255,"blue":64,"green":64,"red":64},"backgroundTintedBase":{"alpha":255,"blue":94,"green":94,"red":94},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":255,"green":255,"red":255}}}}}}],"episodes":[{"id":"3rvl30aWNqZbWi9dnolG3a","__typename":"Episode","contentRating":{"label":"NONE"},"coverArt":{"extractedColors":{"colorDark":{"hex":"#484848","isFallback":false}},"sources":[{"height":64,"url":"https://i.scdn.co/image/ab6765630000f68d35af1b9c3ee719329f85f229","width":64}]},"description":"Get our Wealth Guide (35+ insights from top investors): https://clickhubspot.com/fvif  Episode 828: Shaan Puri ( https://x.com/ShaanVP ) and Sam Parr ( https://x.com/theSamParr ) talk to billionaire Joe Liemandt ( https://x.com/jliemandt ) about the experiment he’s put $1,000,000,000 of his own money into. — Show Notes:  (0:00) Joe, the total man? (08:09) fighting bill gates for talent (13:14) intensity (16:18) choosing hard over easy (19:00) how to be a magnet (21:34) high standards (23:29) being persuasive  (29:23) simplicity: 3 ines, 3 words  (34:41) is 2x faster really better? (36:23) making kids run a 5k (38:45) why be public now (41:01) why put $1b into the lowest roi thing? (50:03) buying SaaS companies (51:06) cloning Warren Buffett's brain (53:00) changing your brain lift (57:19) is AI going to make everyone dumb?  — Links: • Alpha School - https://alpha.school/  • 10 to 25: The Science of Motivating Young People - https://a.co/d/048Cfexh  — Check Out Sam's Stuff: • Hampton (joinhampton.com): My community for founders. Average member does $25m/year. Many of the guests are members. Get after it...apply: http://joinhampton.com/mfm — Check Out Shaan's Stuff: • Shaan's weekly email - https://www.shaanpuri.com  • Visit https://www.somewhere.com/mfm to hire worldwide talent like Shaan and get $500 off for being an MFM listener. Hire developers, assistants, marketing pros, sales teams and more for 80% less than US equivalents. • Mercury - Need a bank for your company? Go check out Mercury (mercury.com). Shaan uses it for all of his companies! Mercury is a financial technology company, not an FDIC-insured bank. Banking services provided by Choice Financial Group, Column, N.A., and Evolve Bank & Trust, Members FDIC • I run all my newsletters on Beehiiv and you should too + we're giving away $10k to our favorite newsletter, check it out: beehiiv.com/mfm-challenge My First Million is a HubSpot Original Podcast // Brought to you by HubSpot Media // Production by Arie Desormeaux // Editing by Ezra Bakker Trupiano / ","duration":{"totalMilliseconds":3903344},"gatedEntityRelations":[],"mediaTypes":["VIDEO"],"name":"The 50 richest families in America are betting on this trend","playability":{"reason":"PLAYABLE"},"playedState":{"playPositionMilliseconds":0,"state":"NOT_STARTED"},"podcastV2":{"__typename":"PodcastResponseWrapper","data":{"__typename":"Podcast","coverArt":{"sources":[{"height":64,"url":"https://i.scdn.co/image/ab6765630000f68d35af1b9c3ee719329f85f229","width":64}]},"mediaType":"MIXED","name":"My First Million","publisher":{"name":"Hubspot"},"uri":"spotify:show:3mliji9352UAk3XnWElnDV"}},"releaseDate":{"isoString":"2026-05-27T08:59:00Z","precision":"MINUTE"},"restrictions":{"paywallContent":false},"uri":"spotify:episode:3rvl30aWNqZbWi9dnolG3a","videoPreviewThumbnail":{"__typename":"VideoThumbnailImage","imagePreview":{"__typename":"ImageV2","sources":[{"maxHeight":720,"maxWidth":1280,"url":"https://image-cdn-fa.spotifycdn.com/image/ab6772ab000030aeae7253d400b6cde5defd1197"}]}},"visualIdentity":{"squareCoverImage":{"__typename":"VisualIdentityImage","extractedColorSet":{"encoreBaseSetTextColor":{"alpha":255,"blue":187,"green":187,"red":187},"highContrast":{"backgroundBase":{"alpha":255,"blue":72,"green":72,"red":72},"backgroundTintedBase":{"alpha":255,"blue":33,"green":33,"red":33},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"higherContrast":{"backgroundBase":{"alpha":255,"blue":53,"green":53,"red":53},"backgroundTintedBase":{"alpha":255,"blue":86,"green":86,"red":86},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":96,"green":215,"red":30},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"minContrast":{"backgroundBase":{"alpha":255,"blue":72,"green":72,"red":72},"backgroundTintedBase":{"alpha":255,"blue":33,"green":33,"red":33},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":255,"green":255,"red":255}}}}}}],"genres":[{"id":"0JQ5IMCbQBLABracA7Zrmn","__typename":"Genre","image":{"extractedColors":{"colorDark":{"hex":"#104848","isFallback":false}},"sources":[{"height":274,"url":"https://t.scdn.co/images/728ed47fc1674feb95f7ac20236eb6d7.jpeg","width":274}]},"name":"Inside the AI Revolution","uri":"spotify:genre:0JQ5IMCbQBLABracA7Zrmn"}],"playlists":[{"id":"2GEFdJC5hCdUFpU1xxFUug","__typename":"Playlist","attributes":[],"description":"","format":"","images":[{"extractedColors":{"colorDark":{"hex":"#767676","isFallback":false}},"sources":[{"height":null,"url":"https://image-cdn-ak.spotifycdn.com/image/ab67706c0000d72c24c483f6c267f53f8625404d","width":null}]}],"name":"Start Here | My First Million","ownerV2":{"__typename":"UserResponseWrapper","data":{"__typename":"User","avatar":{"sources":[{"height":64,"url":"https://i.scdn.co/image/ab67757000003b829da4040165ac26081197ade4","width":64}]},"name":"HubSpot Podcast Network","uri":"spotify:user:31i2jq7ljcu7ob5pk6w2flztsoo4","username":"31i2jq7ljcu7ob5pk6w2flztsoo4"}},"uri":"spotify:playlist:2GEFdJC5hCdUFpU1xxFUug","visualIdentity":{"squareCoverImage":{"__typename":"VisualIdentityImage","extractedColorSet":{"encoreBaseSetTextColor":{"alpha":255,"blue":192,"green":192,"red":192},"highContrast":{"backgroundBase":{"alpha":255,"blue":83,"green":83,"red":83},"backgroundTintedBase":{"alpha":255,"blue":51,"green":51,"red":51},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"higherContrast":{"backgroundBase":{"alpha":255,"blue":53,"green":53,"red":53},"backgroundTintedBase":{"alpha":255,"blue":86,"green":86,"red":86},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":96,"green":215,"red":30},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"minContrast":{"backgroundBase":{"alpha":255,"blue":153,"green":153,"red":153},"backgroundTintedBase":{"alpha":255,"blue":128,"green":128,"red":128},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":255,"green":255,"red":255}}}}}}],"podcasts":[{"id":"3mliji9352UAk3XnWElnDV","__typename":"Podcast","coverArt":{"extractedColors":{"colorDark":{"hex":"#484848","isFallback":false}},"sources":[{"height":64,"url":"https://i.scdn.co/image/ab6765630000f68d35af1b9c3ee719329f85f229","width":64}]},"mediaType":"MIXED","name":"My First Million","publisher":{"name":"Hubspot"},"topics":[{"__typename":"PodcastTopic","title":"Business","uri":"spotify:genre:0JQ5DAqbMKFK0EBNV8Wn6R"}],"uri":"spotify:show:3mliji9352UAk3XnWElnDV","visualIdentity":{"squareCoverImage":{"__typename":"VisualIdentityImage","extractedColorSet":{"encoreBaseSetTextColor":{"alpha":255,"blue":187,"green":187,"red":187},"highContrast":{"backgroundBase":{"alpha":255,"blue":72,"green":72,"red":72},"backgroundTintedBase":{"alpha":255,"blue":33,"green":33,"red":33},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"higherContrast":{"backgroundBase":{"alpha":255,"blue":53,"green":53,"red":53},"backgroundTintedBase":{"alpha":255,"blue":86,"green":86,"red":86},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":96,"green":215,"red":30},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"minContrast":{"backgroundBase":{"alpha":255,"blue":72,"green":72,"red":72},"backgroundTintedBase":{"alpha":255,"blue":33,"green":33,"red":33},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":255,"green":255,"red":255}}}}}}],"topResultsV2":[{"id":"3mliji9352UAk3XnWElnDV","__typename":"Podcast","coverArt":{"extractedColors":{"colorDark":{"hex":"#484848","isFallback":false}},"sources":[{"height":64,"url":"https://i.scdn.co/image/ab6765630000f68d35af1b9c3ee719329f85f229","width":64}]},"mediaType":"MIXED","name":"My First Million","publisher":{"name":"Hubspot"},"topics":[{"__typename":"PodcastTopic","title":"Business","uri":"spotify:genre:0JQ5DAqbMKFK0EBNV8Wn6R"}],"uri":"spotify:show:3mliji9352UAk3XnWElnDV","visualIdentity":{"squareCoverImage":{"__typename":"VisualIdentityImage","extractedColorSet":{"encoreBaseSetTextColor":{"alpha":255,"blue":187,"green":187,"red":187},"highContrast":{"backgroundBase":{"alpha":255,"blue":72,"green":72,"red":72},"backgroundTintedBase":{"alpha":255,"blue":33,"green":33,"red":33},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"higherContrast":{"backgroundBase":{"alpha":255,"blue":53,"green":53,"red":53},"backgroundTintedBase":{"alpha":255,"blue":86,"green":86,"red":86},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":96,"green":215,"red":30},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"minContrast":{"backgroundBase":{"alpha":255,"blue":72,"green":72,"red":72},"backgroundTintedBase":{"alpha":255,"blue":33,"green":33,"red":33},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":255,"green":255,"red":255}}}}}}],"tracksV2":[{"__typename":"Track","albumOfTrack":{"coverArt":{"extractedColors":{"colorDark":{"hex":"#C0591A","isFallback":false}},"sources":[{"height":300,"url":"https://i.scdn.co/image/ab67616d00001e0288c0b52eb38719ef4de33126","width":300}]},"id":"0if4nypvSlgICcSKq8Xmm8","name":"Spurs & Spokes / Bull > Matador - EP","uri":"spotify:album:0if4nypvSlgICcSKq8Xmm8","visualIdentity":{"squareCoverImage":{"__typename":"VisualIdentityImage","extractedColorSet":{"encoreBaseSetTextColor":{"alpha":255,"blue":113,"green":165,"red":255},"highContrast":{"backgroundBase":{"alpha":255,"blue":0,"green":47,"red":146},"backgroundTintedBase":{"alpha":255,"blue":0,"green":6,"red":97},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":155,"green":192,"red":255}},"higherContrast":{"backgroundBase":{"alpha":255,"blue":0,"green":7,"red":101},"backgroundTintedBase":{"alpha":255,"blue":41,"green":54,"red":145},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":96,"green":215,"red":30},"textSubdued":{"alpha":255,"blue":155,"green":192,"red":255}},"minContrast":{"backgroundBase":{"alpha":255,"blue":32,"green":112,"red":240},"backgroundTintedBase":{"alpha":255,"blue":0,"green":85,"red":210},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":255,"green":255,"red":255}}}}}},"artists":[{"profile":{"name":"Fake Problems"},"uri":"spotify:artist:3w2meNoSt1JmZaw6QZD35l"}],"associationsV3":{"audioAssociations":{"totalCount":0},"videoAssociations":{"totalCount":0}},"contentRating":{"label":"NONE"},"duration":{"totalMilliseconds":162840},"id":"1QlYhKt1pomveBX7W3MbqL","trackMediaType":"AUDIO","name":"My First Million","playability":{"playable":true,"reason":"PLAYABLE"},"uri":"spotify:track:1QlYhKt1pomveBX7W3MbqL","visualIdentity":{"sixteenByNineCoverImage":null}}],"users":[]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/spotify/podcast":{"post":{"operationId":"social_spotify_podcast","x-nexscope-slug":"social-spotify-podcast","summary":"Spotify Podcast","description":"Retrieves detailed information about a Spotify podcast by its id or URL. Spotify calls podcasts shows internally, so Spotify podcast URLs use /show/. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Spotify Podcast API View Pricing Get Spotify podcast 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Spotify podcast id. If you'd prefer to use the URL instead, you can use the url parameter instead."},"url":{"type":"string","description":"Spotify podcast URL. If you'd prefer to use the id instead, you can use the id parameter instead."}},"required":[],"additionalProperties":false},"example":{"url":"https://open.spotify.com/show/3mliji9352UAk3XnWElnDV"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"spotify","data":{"success":true,"id":"3mliji9352UAk3XnWElnDV","uri":"spotify:show:3mliji9352UAk3XnWElnDV","__typename":"Podcast","accessInfo":null,"consumptionOrderV2":"RECENT","contentCapabilityTrait":{"rateability":{"value":"RESTRICTED"}},"contentRatingV2":{"labels":["EXPLICIT"]},"contentType":"CONTENT_TYPE_PODCAST","coverArt":{"sources":[{"height":64,"url":"https://i.scdn.co/image/ab6765630000f68d35af1b9c3ee719329f85f229","width":64}]},"description":"Sam Parr and Shaan Puri brainstorm new business ideas based on trends & opportunities they see in the market. Sometimes they bring on famous guests to brainstorm with them.","episodesV2":[{"entity":{"__typename":"EpisodeResponseWrapper","data":{"__typename":"Episode","creator":null,"uri":"spotify:episode:3rvl30aWNqZbWi9dnolG3a"}}}],"gatedEntityRelations":[],"htmlDescription":"<p>Sam Parr and Shaan Puri brainstorm new business ideas based on trends &amp; opportunities they see in the market. Sometimes they bring on famous guests to brainstorm with them.</p>","mediaType":"MIXED","musicAndTalk":false,"name":"My First Million","playability":{"playable":true,"reason":"PLAYABLE","unplayabilityReasons":[]},"publisher":{"name":"Hubspot"},"rating":{"averageRating":{"average":4.781243982283851,"showAverage":true,"totalRatings":5193},"canRate":true,"rating":{"rating":0}},"saved":false,"sharingInfo":{"shareId":"lSCdV7bhQ7CO4dDMM691rA","shareUrl":"https://open.spotify.com/show/3mliji9352UAk3XnWElnDV?si=lSCdV7bhQ7CO4dDMM691rA"},"showTypes":[],"topics":[{"__typename":"PodcastTopic","title":"Business","uri":"spotify:genre:0JQ5DAqbMKFK0EBNV8Wn6R"}],"trailerV2":null,"visualIdentity":{"sixteenByNineCoverImage":null,"squareCoverImage":{"__typename":"VisualIdentityImage","extractedColorSet":{"encoreBaseSetTextColor":{"alpha":255,"blue":187,"green":187,"red":187},"highContrast":{"backgroundBase":{"alpha":255,"blue":72,"green":72,"red":72},"backgroundTintedBase":{"alpha":255,"blue":33,"green":33,"red":33},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"higherContrast":{"backgroundBase":{"alpha":255,"blue":53,"green":53,"red":53},"backgroundTintedBase":{"alpha":255,"blue":86,"green":86,"red":86},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":96,"green":215,"red":30},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"minContrast":{"backgroundBase":{"alpha":255,"blue":72,"green":72,"red":72},"backgroundTintedBase":{"alpha":255,"blue":33,"green":33,"red":33},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":255,"green":255,"red":255}}}}}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/spotify/podcast/episodes":{"post":{"operationId":"social_spotify_podcast_episodes","x-nexscope-slug":"social-spotify-podcast-episodes","summary":"Spotify Podcast Episodes","description":"Returns episodes for a Spotify podcast. Pass the cursor returned by a response to get the next page. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Spotify Podcast Episodes API View Pricing Get Spotify podcast episodes 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Spotify podcast id. If you'd prefer to use the URL instead, you can use the url parameter instead."},"url":{"type":"string","description":"Spotify podcast URL. If you'd prefer to use the id instead, you can use the id parameter instead."},"cursor":{"type":"number","description":"Cursor returned by the previous response. Omit for the first page."}},"required":[],"additionalProperties":false},"example":{"url":"https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"spotify","data":{"success":true,"id":"3mliji9352UAk3XnWElnDV","uri":"spotify:show:3mliji9352UAk3XnWElnDV","episodes":[{"__typename":"Episode","accessInfo":null,"audio":[{"url":"https://p.scdn.co/mp3-preview/2cd8dd37b64a10c1f7cfc194172cca5887006cd3"}],"contentInformation":null,"contentRating":{"label":"NONE"},"contentRatingsV2":null,"contents":[],"coverArt":{"sources":[{"height":64,"url":"https://i.scdn.co/image/ab6765630000f68d35af1b9c3ee719329f85f229","width":64}]},"creator":null,"description":"Get our Wealth Guide (35+ insights from top investors): https://clickhubspot.com/fvif  Episode 828: Shaan Puri ( https://x.com/ShaanVP ) and Sam Parr ( https://x.com/theSamParr ) talk to billionaire Joe Liemandt ( https://x.com/jliemandt ) about the experiment he’s put $1,000,000,000 of his own money into. — Show Notes:  (0:00) Joe, the total man? (08:09) fighting bill gates for talent (13:14) intensity (16:18) choosing hard over easy (19:00) how to be a magnet (21:34) high standards (23:29) being persuasive  (29:23) simplicity: 3 ines, 3 words  (34:41) is 2x faster really better? (36:23) making kids run a 5k (38:45) why be public now (41:01) why put $1b into the lowest roi thing? (50:03) buying SaaS companies (51:06) cloning Warren Buffett's brain (53:00) changing your brain lift (57:19) is AI going to make everyone dumb?  — Links: • Alpha School - https://alpha.school/  • 10 to 25: The Science of Motivating Young People - https://a.co/d/048Cfexh  — Check Out Sam's Stuff: • Hampton (joinhampton.com): My community for founders. Average member does $25m/year. Many of the guests are members. Get after it...apply: http://joinhampton.com/mfm — Check Out Shaan's Stuff: • Shaan's weekly email - https://www.shaanpuri.com  • Visit https://www.somewhere.com/mfm to hire worldwide talent like Shaan and get $500 off for being an MFM listener. Hire developers, assistants, marketing pros, sales teams and more for 80% less than US equivalents. • Mercury - Need a bank for your company? Go check out Mercury (mercury.com). Shaan uses it for all of his companies! Mercury is a financial technology company, not an FDIC-insured bank. Banking services provided by Choice Financial Group, Column, N.A., and Evolve Bank & Trust, Members FDIC • I run all my newsletters on Beehiiv and you should too + we're giving away $10k to our favorite newsletter, check it out: beehiiv.com/mfm-challenge My First Million is a HubSpot Original Podcast // Brought to you by HubSpot Media // Production by Arie Desormeaux // Editing by Ezra Bakker Trupiano / ","duration":{"totalMilliseconds":3903344},"gatedEntityRelations":[],"htmlDescription":"<p>Get our Wealth Guide (35&#43; insights from top investors):<a href=\"https://clickhubspot.com/fvif\" rel=\"nofollow\"> https://clickhubspot.com/fvif</a></p><br/><p><br /></p><br/><p>Episode 828: Shaan Puri ( <a href=\"https://x.com/ShaanVP\" rel=\"nofollow\">https://x.com/ShaanVP</a> ) and Sam Parr ( <a href=\"https://x.com/theSamParr\" rel=\"nofollow\">https://x.com/theSamParr</a> ) talk to billionaire Joe Liemandt ( <a href=\"https://x.com/jliemandt\" rel=\"nofollow\">https://x.com/jliemandt</a> ) about the experiment he’s put $1,000,000,000 of his own money into.</p><br/><p>—</p><br/><p>Show Notes: </p><br/><p>(0:00) Joe, the total man?</p><br/><p>(08:09) fighting bill gates for talent</p><br/><p>(13:14) intensity</p><br/><p>(16:18) choosing hard over easy</p><br/><p>(19:00) how to be a magnet</p><br/><p>(21:34) high standards</p><br/><p>(23:29) being persuasive </p><br/><p>(29:23) simplicity: 3 ines, 3 words </p><br/><p>(34:41) is 2x faster really better?</p><br/><p>(36:23) making kids run a 5k</p><br/><p>(38:45) why be public now</p><br/><p>(41:01) why put $1b into the lowest roi thing?</p><br/><p>(50:03) buying SaaS companies</p><br/><p>(51:06) cloning Warren Buffett&#39;s brain</p><br/><p>(53:00) changing your brain lift</p><br/><p>(57:19) is AI going to make everyone dumb?</p><br/><p><br /></p><br/><p>—</p><br/><p>Links:</p><br/><p>• Alpha School - <a href=\"https://alpha.school/\" rel=\"nofollow\">https://alpha.school/</a> </p><br/><p>• 10 to 25: The Science of Motivating Young People - <a href=\"https://a.co/d/048Cfexh\" rel=\"nofollow\">https://a.co/d/048Cfexh</a> </p><br/><p>—</p><br/><p>Check Out Sam&#39;s Stuff:</p><br/><p>• Hampton (joinhampton.com): My community for founders. Average member does $25m/year. Many of the guests are members. Get after it...apply: http://joinhampton.com/mfm</p><br/><p>—</p><br/><p>Check Out Shaan&#39;s Stuff:</p><br/><p>• Shaan&#39;s weekly email - <a href=\"https://www.shaanpuri.com\" rel=\"nofollow\">https://www.shaanpuri.com</a> </p><br/><p>• Visit <a href=\"https://www.somewhere.com/mfm\" rel=\"nofollow\">https://www.somewhere.com/mfm</a> to hire worldwide talent like Shaan and get $500 off for being an MFM listener. Hire developers, assistants, marketing pros, sales teams and more for 80% less than US equivalents.</p><br/><p>• Mercury - Need a bank for your company? Go check out Mercury (mercury.com). Shaan uses it for all of his companies!</p><br/><p>Mercury is a financial technology company, not an FDIC-insured bank. Banking services provided by Choice Financial Group, Column, N.A., and Evolve Bank &amp; Trust, Members FDIC</p><br/><p>• I run all my newsletters on Beehiiv and you should too &#43; we&#39;re giving away $10k to our favorite newsletter, check it out:</p><br/><p>beehiiv.com/mfm-challenge</p><br/><p>My First Million is a HubSpot Original Podcast // Brought to you by HubSpot Media // Production by Arie Desormeaux // Editing by Ezra Bakker Trupiano /</p><br/><p><br /></p>","id":"3rvl30aWNqZbWi9dnolG3a","mediaTypes":["AUDIO"],"name":"The 50 richest families in America are betting on this trend","playability":{"playable":true,"reason":"PLAYABLE","unplayabilityReasons":[]},"playedState":{"playPositionMilliseconds":0,"state":"NOT_STARTED"},"podcastV2":{"__typename":"Podcast","coverArt":{"sources":[{"height":64,"url":"https://i.scdn.co/image/ab6765630000f68d35af1b9c3ee719329f85f229","width":64}]},"name":"My First Million","showTypes":[],"trailerV2":null,"uri":"spotify:show:3mliji9352UAk3XnWElnDV","accessInfo":null},"previewPlayback":{"audioPreview":{"cdnUrl":"https://p.scdn.co/mp3-preview/b6e83bb5e3142367e192e45865e7c64cb2f39483.mp3"}},"releaseDate":{"isoString":"2026-05-27T08:59:00Z","precision":"MINUTE"},"restrictions":{"paywallContent":false},"segments":null,"sharingInfo":{"shareId":"-xrq7hW_Qn2886yuMzLkyg","shareUrl":"https://open.spotify.com/episode/3rvl30aWNqZbWi9dnolG3a?si=-xrq7hW_Qn2886yuMzLkyg"},"transcripts":[],"type":"PODCAST_EPISODE","uri":"spotify:episode:3rvl30aWNqZbWi9dnolG3a","visualIdentity":{"sixteenByNineCoverImage":{"image":{"__typename":"ImageV2","sources":[{"maxHeight":720,"maxWidth":1280,"url":"https://image-cdn-ak.spotifycdn.com/image/ab6772ab000030aeae7253d400b6cde5defd1197"}]}},"squareCoverImage":{"__typename":"VisualIdentityImage","extractedColorSet":{"encoreBaseSetTextColor":{"alpha":255,"blue":187,"green":187,"red":187},"highContrast":{"backgroundBase":{"alpha":255,"blue":72,"green":72,"red":72},"backgroundTintedBase":{"alpha":255,"blue":33,"green":33,"red":33},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"higherContrast":{"backgroundBase":{"alpha":255,"blue":53,"green":53,"red":53},"backgroundTintedBase":{"alpha":255,"blue":86,"green":86,"red":86},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":96,"green":215,"red":30},"textSubdued":{"alpha":255,"blue":205,"green":205,"red":205}},"minContrast":{"backgroundBase":{"alpha":255,"blue":72,"green":72,"red":72},"backgroundTintedBase":{"alpha":255,"blue":33,"green":33,"red":33},"textBase":{"alpha":255,"blue":255,"green":255,"red":255},"textBrightAccent":{"alpha":255,"blue":255,"green":255,"red":255},"textSubdued":{"alpha":255,"blue":255,"green":255,"red":255}}}}}}],"cursor":50,"totalCount":868},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/soundcloud/artist":{"post":{"operationId":"social_soundcloud_artist","x-nexscope-slug":"social-soundcloud-artist","summary":"SoundCloud Artist","description":"Fetches detailed information about a SoundCloud artist by its handle or URL. Returns artist metadata including id, name, followers, etc Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. SoundCloud Artist API View Pricing Get SoundCloud artist details and follower counts by handle or URL. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"SoundCloud artist handle. If you'd prefer to use the URL instead, you can use the url parameter instead."},"url":{"type":"string","description":"SoundCloud artist URL. If you'd prefer to use the handle instead, you can use the handle parameter instead."}},"required":[],"additionalProperties":false},"example":{"handle":"kehlanimusic"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"soundcloud","data":{"success":true,"avatar_url":"https://i1.sndcdn.com/avatars-4pU1zic9ZyyDdF4G-dF6LHA-large.jpg","city":"Oakland, CA","comments_count":0,"country_code":"US","created_at":null,"creator_subscriptions":[{"product":{"id":"creator-pro-unlimited"}}],"creator_subscription":{"product":{"id":"creator-pro-unlimited"}},"description":"\"Folded\" out now!\n\nSinger/Songwriter \nOakland to Los Angeles\n\nMGMT:\ndavid@abvgrnd.com\ninfo@thetsunamimob.com\n\nBOOKING:\nCaroline Yim\ncaroline.yim@caa.com","followers_count":841535,"followings_count":0,"first_name":"","full_name":"","groups_count":0,"id":51562330,"kind":"user","last_modified":"2025-06-12T20:52:01Z","last_name":"","likes_count":11,"playlist_likes_count":2,"permalink":"kehlanimusic","permalink_url":"https://soundcloud.com/kehlanimusic","playlist_count":26,"reposts_count":null,"track_count":331,"uri":"https://api.soundcloud.com/users/soundcloud%3Ausers%3A51562330","urn":"soundcloud:users:51562330","username":"Kehlani","verified":true,"visuals":{"urn":"soundcloud:users:51562330","enabled":true,"visuals":[{"urn":"soundcloud:visuals:243626019","entry_time":0,"visual_url":"https://i1.sndcdn.com/visuals-000051562330-BFF9AP-original.jpg"}],"tracking":null},"badges":{"pro":false,"creator_mid_tier":false,"pro_unlimited":true,"verified":true},"station_urn":"soundcloud:system-playlists:artist-stations:51562330","station_permalink":"artist-stations:51562330","date_of_birth":null},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/soundcloud/artist/tracks":{"post":{"operationId":"social_soundcloud_artist_tracks","x-nexscope-slug":"social-soundcloud-artist-tracks","summary":"SoundCloud Artist Tracks","description":"Fetches tracks/songs for a SoundCloud artist by handle or URL. Returns the artist profile, track list, and pagination info from SoundCloud. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. SoundCloud Artist Tracks API View Pricing Gets tracks/songs for a SoundCloud artist by handle or URL. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"SoundCloud artist handle. If you'd prefer to use the URL instead, you can use the url parameter instead."},"url":{"type":"string","description":"SoundCloud artist tracks URL. If you'd prefer to use the handle instead, you can use the handle parameter instead."},"cursor":{"type":"string","description":"Cursor to get more tracks. Get 'cursor' from previous response."}},"required":[],"additionalProperties":false},"example":{"handle":"kehlanimusic"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"soundcloud","data":{"success":true,"tracks":[{"artwork_url":"https://i1.sndcdn.com/artworks-RCKR3Fvp7iD1-0-large.jpg","caption":null,"commentable":true,"comment_count":19,"created_at":"2026-04-22T00:39:25Z","description":null,"downloadable":false,"download_count":0,"duration":179351,"full_duration":179305,"embeddable_by":"all","genre":"R&B","has_downloads_left":false,"id":2306956232,"kind":"track","label_name":"TSNMI / Atlantic","last_modified":"2026-05-12T16:04:50Z","license":"all-rights-reserved","likes_count":1365,"permalink":"lights-on-feat-big-sean","permalink_url":"https://soundcloud.com/kehlanimusic/lights-on-feat-big-sean","playback_count":28691,"public":true,"publisher_metadata":{"id":2306956232,"urn":"soundcloud:tracks:2306956232","artist":"Kehlani","album_title":"Kehlani","contains_music":true,"upc_or_ean":"075679576071","isrc":"USAT22601414","explicit":true,"p_line":"℗ 2026 Atlantic Records Group LLC","p_line_for_display":"℗ 2026 Atlantic Records Group LLC","c_line":"© 2026 Atlantic Records Group LLC","c_line_for_display":"© 2026 Atlantic Records Group LLC","release_title":"Lights On (feat. Big Sean)"},"purchase_title":null,"purchase_url":null,"release_date":"2026-04-23T00:00:00Z","reposts_count":26,"sharing":"public","state":"finished","streamable":true,"tag_list":"","title":"Lights On (feat. Big Sean)","uri":"https://api.soundcloud.com/tracks/soundcloud%3Atracks%3A2306956232","urn":"soundcloud:tracks:2306956232"}],"cursor":"2026-04-23T00:00:00.000Z,tracks,00000000002319251642"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/soundcloud/track":{"post":{"operationId":"social_soundcloud_track","x-nexscope-slug":"social-soundcloud-track","summary":"SoundCloud Track","description":"Fetches detailed information about a SoundCloud track/song by URL. Returns track title, plays, likes, reposts, comments, artwork, artist, and other SoundCloud metadata. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. SoundCloud Track API View Pricing Gets detailed information about a SoundCloud track/song by URL. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"SoundCloud track URL."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://soundcloud.com/kehlanimusic/lights-on-feat-big-sean"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"soundcloud","data":{"success":true,"artwork_url":"https://i1.sndcdn.com/artworks-RCKR3Fvp7iD1-0-large.jpg","caption":null,"commentable":true,"comment_count":19,"created_at":"2026-04-22T00:39:25Z","description":null,"downloadable":false,"download_count":0,"duration":179351,"full_duration":179305,"embeddable_by":"all","genre":"R&B","has_downloads_left":false,"id":2306956232,"kind":"track","label_name":"TSNMI / Atlantic","last_modified":"2026-05-12T16:04:50Z","license":"all-rights-reserved","likes_count":1365,"permalink":"lights-on-feat-big-sean","permalink_url":"https://soundcloud.com/kehlanimusic/lights-on-feat-big-sean","playback_count":28693,"public":true,"publisher_metadata":{"id":2306956232,"urn":"soundcloud:tracks:2306956232","artist":"Kehlani","album_title":"Kehlani","contains_music":true,"upc_or_ean":"075679576071","isrc":"USAT22601414","explicit":true,"p_line":"℗ 2026 Atlantic Records Group LLC","p_line_for_display":"℗ 2026 Atlantic Records Group LLC","c_line":"© 2026 Atlantic Records Group LLC","c_line_for_display":"© 2026 Atlantic Records Group LLC","release_title":"Lights On (feat. Big Sean)"},"purchase_title":null,"purchase_url":null,"release_date":"2026-04-23T00:00:00Z","reposts_count":26,"sharing":"public","state":"finished","streamable":true,"tag_list":"","title":"Lights On (feat. Big Sean)"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/kwai/profile":{"post":{"operationId":"social_kwai_profile","x-nexscope-slug":"social-kwai-profile","summary":"Kwai Profile","description":"Fetches public Kwai profile data including username, bio, avatar, verification status, gender, and public counts. Uses Kwai's public web API endpoint, not HTML scraping. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Kwai Profile API View Pricing Get public Kwai profile info from a handle or profile URL. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Kwai profile handle. Use this or url."},"url":{"type":"string","description":"Kwai profile URL. Use this or handle."}},"required":[],"additionalProperties":false},"example":{"handle":"KwaiBrasilOficial"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"kwai","data":{"success":true,"data":{"id":558843093,"eid":"3xyutri4afq3qks","handle":"KwaiBrasilOficial","username":"Kwai Brasil Oficial","bio":"Aqui, Geral Brilha ✨","url":"https://www.kwai.com/@KwaiBrasilOficial","avatar_url":"https://ak-br-pic.kwai.net/bs2/overseaHead/20260430040305_BNTU4ODQzMDkz_s.jpg","verified":true,"verified_description":"Conta Oficial","verified_number":null,"gender":null,"follower_count":1,"following_count":1,"like_count":17467236,"public_post_count":3261,"private_post_count":0,"is_private":false}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/kwai/user/posts":{"post":{"operationId":"social_kwai_user_posts","x-nexscope-slug":"social-kwai-user-posts","summary":"Kwai User Posts","description":"Fetches a paginated list of public Kwai posts for a user, including captions, media URLs, covers, counts, author info, and the next cursor when more results are available. Uses Kwai's public web API endpoint, not HTML scraping. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Kwai User Posts API View Pricing Get public posts from a Kwai handle or profile URL. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Kwai profile handle. Use this or url."},"url":{"type":"string","description":"Kwai profile URL. Use this or handle."},"count":{"type":"number","description":"Number of posts to return, max 50"},"cursor":{"type":"string","description":"Cursor from the previous response for the next page"}},"required":[],"additionalProperties":false},"example":{"handle":"KwaiBrasilOficial"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"kwai","data":{"success":true,"data":{"posts":[{"id":"5193363430624671876","photo_id":5193363430624672000,"url":"https://www.kwai.com/@KwaiBrasilOficial/photo/5193363430624671876","caption":"O Marquinhos entrou em campo e realizou o maior sonho da vida da sua avó...","created_at":"2026-06-07T03:00:00.028Z","created_at_text":"2026-06-07 03:00:00","video_url":"https://ak-br-cdn.kwai.net/upic/example.mp4","cover_url":"https://ak-br-pic.kwai.net/upic/example.webp","view_count":12345,"like_count":678,"comment_count":9,"forward_count":10,"author":{"id":558843093,"handle":"KwaiBrasilOficial","username":"Kwai Brasil Oficial","avatar_url":"https://ak-br-pic.kwai.net/bs2/overseaHead/20260430040305_BNTU4ODQzMDkz_s.jpg","verified":true,"verified_description":"Conta Oficial"},"music":{"id":13337080415,"name":"","artist":"Kwai Brasil Oficial","url":"https://ak-br-pic.kwai.net/bs2/ost/example.m4a"},"tags":[]}],"albums":[],"cursor":"1780704000032","has_more":true}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/kwai/post":{"post":{"operationId":"social_kwai_post","x-nexscope-slug":"social-kwai-post","summary":"Kwai Post","description":"Fetches public Kwai post details including caption, media URLs, cover images, counts, author info, and music metadata. Uses Kwai's public web API endpoint, not HTML scraping. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Kwai Post API View Pricing Get public Kwai post details from a post URL. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Kwai post URL"}},"required":[],"additionalProperties":false},"example":{"url":"https://www.kwai.com/@KwaiBrasilOficial/photo/5193363430624671876"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"kwai","data":{"success":true,"data":{"id":"5193363430624671876","photo_id":5193363430624672000,"url":"https://www.kwai.com/@KwaiBrasilOficial/photo/5193363430624671876","caption":"O Marquinhos entrou em campo e realizou o maior sonho da vida da sua avó...","created_at":"2026-06-07T03:00:00.028Z","created_at_text":"2026-06-07 03:00:00","video_url":"https://ak-br-cdn.kwai.net/upic/example.mp4","cover_url":"https://ak-br-pic.kwai.net/upic/example.webp","view_count":12345,"like_count":678,"comment_count":9,"forward_count":10,"author":{"id":558843093,"handle":"KwaiBrasilOficial","username":"Kwai Brasil Oficial","avatar_url":"https://ak-br-pic.kwai.net/bs2/overseaHead/20260430040305_BNTU4ODQzMDkz_s.jpg","verified":true,"verified_description":"Conta Oficial"},"music":{"id":13337080415,"name":"","artist":"Kwai Brasil Oficial","url":"https://ak-br-pic.kwai.net/bs2/ost/example.m4a"},"tags":[]}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/kick/clip/transcript":{"post":{"operationId":"social_kick_clip_transcript","x-nexscope-slug":"social-kick-clip-transcript","summary":"Kick Clip Transcript","description":"Gets a transcript from a public Kick clip. Checks native captions first; returned native captions cost 1 credit. Set use_ai_as_fallback=true to opt into paid AI only when captions are unavailable. No transcript costs 0 credits. transcript_source is native, ai, or null. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Kick Clip Transcript API View Pricing Get native captions from a Kick clip. Enable use_ai_as_fallback for AI when captions are unavailable. Native captions or AI up to 2 minutes: 1 credit. Paid AI mode: 10 credits/minute, rounded up, even for short videos. No transcript: 0 credits.\nGets a transcript from a public Kick clip. Checks native captions first; returned native captions cost 1 credit. Set use_ai_as_fallback=true to opt into paid AI only when captions are unavailable. No transcript costs 0 credits. transcript_source is native, ai, or null. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nPaid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nUse paid AI only when native captions are unavailable. Defaults to false. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.\nCurrent official page: returned native captions or successful default AI up to 120 seconds cost 1; no transcript 0. AI fallback is separately enabled. With literal allow_long_transcription=true, all successful AI, including short, costs 10 per started minute; empty AI/errors have no AI fee.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Kick clip URL"},"allow_long_transcription":{"type":"boolean","default":false,"description":"Paid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed."},"use_ai_as_fallback":{"type":"boolean","description":"Use paid AI only when native captions are unavailable. Defaults to false. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://kick.com/xqc/clips/clip_01HCA3XAXSJGPQKSAV88Y94XFJ"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"kick","data":{"success":true,"id":"clip_01M35J4DGERS1WE12H82WW0JBB","url":"https://kick.com/fuzzyzvr/clips/clip_01M35J4DGERS1WE12H82WW0JBB","transcript":null,"transcript_source":null},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/kick/clip":{"post":{"operationId":"social_kick_clip","x-nexscope-slug":"social-kick-clip","summary":"Kick Clip","description":"Fetches detailed data for a Kick clip by URL, including video, metadata, and channel info. Returns clip id, title, clip_url, thumbnail_url, video_url, view_count, likes_count, duration, privacy status, and is_mature flag. Also includes category details (name, slug), creator info (username), and channel info (username, profile_picture). Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Kick Clip API View Pricing Get Kick clip 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Kick clip URL"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://kick.com/xqc/clips/clip_01JGJHB6CEVFCQRYTVPM8DW892"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"kick","data":{"success":true,"clip":{"id":"clip_01JGJHB6CEVFCQRYTVPM8DW892","livestream_id":"45013036","category_id":"15","channel_id":668,"user_id":13035177,"title":"MonkaW","clip_url":"https://clips.kick.com/clips/7a/clip_01JGJHB6CEVFCQRYTVPM8DW892/playlist.m3u8","thumbnail_url":"https://clips.kick.com/clips/7a/clip_01JGJHB6CEVFCQRYTVPM8DW892/thumbnail.webp","privacy":"CLIP_PRIVACY_PUBLIC","likes":0,"liked":false,"views":11793,"duration":50,"started_at":"2025-01-02T03:34:51.825Z","created_at":"2025-01-02T03:37:13.559618Z","is_mature":false,"video_url":"https://clips.kick.com/clips/7a/clip_01JGJHB6CEVFCQRYTVPM8DW892/playlist.m3u8","view_count":11793,"likes_count":0,"vod":{"id":"2ba60535-342e-4397-b16a-fb739ca96b21"},"category":{"id":15,"name":"Just Chatting","slug":"just-chatting","responsive":"https://files.kick.com/images/subcategories/15/banner/b697a8a3-62db-4779-aa76-e4e47662af97","banner":"https://files.kick.com/images/subcategories/15/banner/b697a8a3-62db-4779-aa76-e4e47662af97","parent_category":"irl"},"creator":{"id":13035177,"username":"cskorm","slug":"cskorm","profile_picture":null},"channel":{"id":668,"username":"xQc","slug":"xqc","profile_picture":"https://files.kick.com/images/user/676/profile_image/conversion/931b4e8f-5445-427c-bd82-b473530390cc-thumb.webp"}}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/snapchat/profile":{"post":{"operationId":"social_snapchat_profile","x-nexscope-slug":"social-snapchat-profile","summary":"Snapchat User Profile","description":"Retrieves a Snapchat user's public profile by handle, including identity, stories, and spotlight content. Returns userProfile with username, title, snapcodeImageUrl, subscriberCount, bio, and profilePictureUrl. Also includes highlightStoryMetadata with individual story snaps (mediaUrl, mediaType, thumbnailUrl) and spotlightStoryMetadata with video details and engagement stats (viewCount, shareCount, commentCount). Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Snapchat User Profile API View Pricing Get Snapchat user profile 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Snapchat username"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"zane"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"snapchat","data":{"success":true,"userProfile":{"username":"zane","title":"Zane","snapcodeImageUrl":"https://app.snapchat.com/web/deeplink/snapcode?username=zane&type=SVG&bitmoji=enable","badge":1,"categoryStringId":"","subcategoryStringId":"","subscriberCount":"1535700","bio":"Time to get buck wild baby","websiteUrl":"","profilePictureUrl":"https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvSG5jNU4zNFh5MWNacFlPR0Y2T3pxP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMjpeg","address":"","bitmoji3d":null,"hasCuratedHighlights":true,"hasSpotlightHighlights":true,"mutableName":"","publisherType":"","squareHeroImageUrl":"https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvZnl5TndBTlZVU1IzckVGWWpuQlZnP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,1080_FMjpeg","primaryColor":"","hasStory":false,"relatedAccountsInfo":[{"publicProfileInfo":{"username":"imnotscottysire","title":"Scotty Sire","snapcodeImageUrl":"","badge":1,"categoryStringId":"","subcategoryStringId":"","subscriberCount":"0","bio":"","websiteUrl":"","profilePictureUrl":"https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2QvZUhZSzNoRVRGcEhLeHFaVEtKOEQwP2JvPUVna3lBUVJJQWxBWllBRSUzRCZ1Yz0yNQ._RS0,640_FMjpeg","address":"","bitmoji3d":null,"hasCuratedHighlights":false,"hasSpotlightHighlights":false,"mutableName":"","publisherType":"","squareHeroImageUrl":"","primaryColor":"","hasStory":true,"relatedAccountsInfo":[],"creationTimestampMs":null,"lastUpdateTimestampMs":null,"businessProfileId":"ebc366e6-3058-4c94-8e85-35a4e50c6737"},"subscribeLink":{"oneLinkBaseUrl":"https://click.snapchat.com/aVHG","pidKeys":["af_pid"],"pidFallbackValue":"consumer_web","campaignKeys":["af_c"],"campaignFallbackValue":"add_user","googleClickIdParam":"af_sub1","deepLinkUrl":"https://www.snapchat.com/add/imnotscottysire?sc_referrer=web","iosAppStoreUrl":"https://apps.apple.com/app/apple-store/id447188370?pt=614006&ct=add_user&mt=8","desktopPageUrl":"https://snapchat.com/download?purpose=web_stories&sp=add_user"}}],"creationTimestampMs":{"value":"1584846804362"},"lastUpdateTimestampMs":{"value":"1741518441231"},"businessProfileId":"e123b268-312b-41d6-8088-b51c12c6f2c6"},"story":null,"curatedHighlights":[{"storyType":3,"snapList":[{"snapIndex":0,"snapId":{"value":""},"snapMediaType":0,"snapUrls":{"mediaUrl":"https://cf-st.sc-cdn.net/d/21JGtXabuZ1AfXw5L5vjB.400.IRZXSOY?mo=GlQaGhoAGgAyAQQ6AX1CBgjusM6eBkgDUF5gAXABWhBQdWJsaWNJbWFnZVN0b3J5ogEQCJADIgsSACoHSVJaWFNPWaIBEAjnByILEgAqB0lSWlhTT1k%3D&uc=94","mediaPreviewUrl":{"value":"https://cf-st.sc-cdn.net/d/21JGtXabuZ1AfXw5L5vjB.410.IRZXSOY?mo=GkEaGhoAGgAyAQQ6AX1CBgjusM6eBkgDUF5gAXABWhBEZkxhcmdlVGh1bWJuYWlsogEQCJoDIgsSACoHSVJaWFNPWQ%3D%3D&uc=94"},"overlayUrl":null,"attachmentUrl":null},"isSponsored":null,"timestampInSec":{"value":"1670431570"},"snapTitle":null,"snapSubtitles":null,"lat":null,"lng":null,"hasAttachment":null,"intervalStartTimeMs":null,"audioTranscriptionObjectUrl":null}],"storyId":{"value":""},"storyTitle":{"value":"FULL HAIR TRANSFORMATION (PART 1)"},"thumbnailUrl":{"value":"https://cf-st.sc-cdn.net/d/bNrrl36C71xV5GeTS13qP.410.IRZXSOY?mo=GkEaGhoAGgAyAQQ6AX1CBgjxsM6eBkgDUF5gAXABWhBEZkxhcmdlVGh1bWJuYWlsogEQCJoDIgsSACoHSVJaWFNPWQ%3D%3D&uc=94"},"storySubtitle":null,"storyShareId":null,"canonicalUrlSuffix":null,"emoji":null,"storyTapId":"0","videoTrackUrl":null,"highlightId":{"value":"39f6379c-1787-4f79-859c-8cee75a8076e"},"isAttributed":null}],"spotlightHighlights":[{"storyType":3,"snapList":[{"snapIndex":0,"snapId":{"value":"W7_EDlXWTBiXAEEniNoMPwAAYZGJ6d3NyYWdiAYdiSHKKAYdiSG6AAAAAAQ"},"snapMediaType":1,"snapUrls":{"mediaUrl":"https://cf-st.sc-cdn.net/d/QV9a3I5ISW0cgJwjHW0BS.1034.IRZXSOY?mo=GkAaDRoAGgAyAQRIA1AuYAGiAS4IiggSHAoaIAFKEQoMY0Y9R0RFR0M5OU8uEPQDWgMQsz8iCxIAKgdJUlpYU09Z&uc=46","mediaPreviewUrl":{"value":"https://cf-st.sc-cdn.net/d/QV9a3I5ISW0cgJwjHW0BS.256.IRZXSOY?mo=GkcaDRoAGgAyAQRIAlAuYAFaEERmTGFyZ2VUaHVtYm5haWyiARAIgAIiCxIAKgdJUlpYU09ZogEQCJoKIgsSACoHSVJaWFNPWQ%3D%3D&uc=46"},"overlayUrl":null,"attachmentUrl":null},"isSponsored":null,"timestampInSec":{"value":"1680981126"},"snapTitle":null,"snapSubtitles":null,"lat":null,"lng":null,"hasAttachment":null,"intervalStartTimeMs":null,"audioTranscriptionObjectUrl":null}],"storyId":{"value":"W7_EDlXWTBiXAEEniNoMPwAAYZGJ6d3NyYWdiAYdiSHKKAYdiSG6AAAAAAQ"},"storyTitle":{"value":""},"thumbnailUrl":{"value":"https://cf-st.sc-cdn.net/d/QV9a3I5ISW0cgJwjHW0BS.256.IRZXSOY?mo=GkcaDRoAGgAyAQRIAlAuYAFaEERmTGFyZ2VUaHVtYm5haWyiARAIgAIiCxIAKgdJUlpYU09ZogEQCJoKIgsSACoHSVJaWFNPWQ%3D%3D&uc=46"},"storySubtitle":null,"storyShareId":null,"canonicalUrlSuffix":null,"emoji":null,"storyTapId":"0","videoTrackUrl":null,"highlightId":{"value":"W7_EDlXWTBiXAEEniNoMPwAAYZGJ6d3NyYWdiAYdiSHKKAYdiSG6AAAAAAQ"},"isAttributed":null}],"spotlightStoryMetadata":[{"videoMetadata":{"name":"Turn around sir","description":"Another Spotlight Snap brought to you by Snapchat","thumbnailUrl":"https://cf-st.sc-cdn.net/d/QV9a3I5ISW0cgJwjHW0BS.256.IRZXSOY?mo=GkcaDRoAGgAyAQRIAlAuYAFaEERmTGFyZ2VUaHVtYm5haWyiARAIgAIiCxIAKgdJUlpYU09ZogEQCJoKIgsSACoHSVJaWFNPWQ%3D%3D&uc=46","uploadDateMs":"1680981126784","viewCount":"11937","contentUrl":"https://cf-st.sc-cdn.net/d/QV9a3I5ISW0cgJwjHW0BS.27.IRZXSOY?mo=GlIaDRoAGgAyAQRIAlAuYAFaEFNwb3RsaWdodFNoYXJpbmeiAS4IGxIdChsgAUoSCg2AAWRTY2VgX21QTXA9EPQDWgMQmT8iCxIAKgdJUlpYU09Z&uc=46","creator":{"$case":"personCreator","personCreator":{"username":"zane","url":"https://www.snapchat.com/add/zane","name":"Zane","followerCount":"0","websiteUrl":""}},"durationMs":"6200","width":540,"height":960,"keywords":[],"shareCount":"0","embeddedTextCaption":"Turn around sir"},"userMetadata":null,"lensMetadata":null,"hashtags":[],"contextCards":[{"contextType":2,"title":"@zane's Sound","subtitle":"","url":"","thumbnailUrl":"https://cf-st.sc-cdn.net/d/6YKRUxipwtyh6YMgtaJbK?bo=Eg0aABoAMgEESAJQCGAB&uc=8","snapcodeUrl":"","thumbnailType":2,"hasBadge":false}],"engagementStats":{"viewCount":"11937","shareCount":"6","commentCount":"10"},"deeplink":"https://click.snapchat.com/aVHG?pid=snapchat_download_page&af_dp=https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYZGJ6d3NyYWdiAYdiSHKKAYdiSG6AAAAAAQ?sc_referrer%3Dweb&af_web_dp=https://snapchat.com/download?purpose%3Dweb_stories%26sp%3Dspotlight&af_ios_url=https://apps.apple.com/app/apple-store/id447188370?pt%3D614006%26ct%3Dspotlight%26mt%3D8","oneLinkParams":{"oneLinkBaseUrl":"https://click.snapchat.com/aVHG","pidKeys":["af_pid"],"pidFallbackValue":"consumer_web","campaignKeys":["af_c"],"campaignFallbackValue":"spotlight","googleClickIdParam":"af_sub1","deepLinkUrl":"https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYZGJ6d3NyYWdiAYdiSHKKAYdiSG6AAAAAAQ?sc_referrer=web","iosAppStoreUrl":"https://apps.apple.com/app/apple-store/id447188370?pt=614006&ct=spotlight&mt=8","desktopPageUrl":"https://snapchat.com/download?purpose=web_stories&sp=spotlight"},"description":""}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/snapchat/spotlight":{"post":{"operationId":"social_snapchat_spotlight","x-nexscope-slug":"social-snapchat-spotlight","summary":"Snapchat Spotlight by Link","description":"Fetches public data for a Snapchat Spotlight video by URL. Returns the snap id, description, creator, engagement counts, thumbnail, and content URL when Snapchat exposes them publicly. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Snapchat Spotlight by Link API View Pricing Get Snapchat Spotlight video data by URL 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Snapchat Spotlight URL."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.snapchat.com/@jack.scalise/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"snapchat","data":{"success":true,"spotlight":{"snapId":"W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ","storyId":"W7_EDlXWTBiXAEEniNoMPwAAYb3djZ3FqY2VhAZXDhShdAZXDhPWfAAAAAQ","description":"You are my favorite notification!\uD83D\uDE04❤️","llmTitle":"Jack Scalise's 'Disturb Me' Challenge: How to Get Noticed Online","llmDescription":"This short-form content features Jack Scalise, a popular social media personality, inviting his audience to participate in a trending 'disturb me' challenge.","viewCount":359935,"shareCount":35057,"commentCount":636,"engagementStats":{"viewCount":359935,"shareCount":35057,"commentCount":636,"boostCount":35666,"recommendCount":1842},"creator":{"$case":"personCreator","personCreator":{"username":"jack.scalise","url":"https://www.snapchat.com/@jack.scalise","name":"Jack Scalise","followerCount":"0","websiteUrl":""}},"durationMs":11200,"width":540,"height":960,"uploadDateMs":1742742025631,"thumbnailUrl":"https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.256.IRZXSOY?mo=GkMaCTIBBEgCUC5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiAAiILEgAqB0lSWlhTT1miARAImgoiCxIAKgdJUlpYU09Z&uc=46","contentUrl":"https://cf-st.sc-cdn.net/d/xL5FK70SP9np2rtr6jkMt.27.IRZXSOY?mo=Gk8aCTIBBEgCUC5gAVoQU3BvdGxpZ2h0U2hhcmluZ6IBKwgbEhoKGAjssDMgAUoOCglJICIpKB4jKSEQ9ANoAiILEgAqB0lSWlhTT1mQA8BX&uc=46","raw":{}},"linkPreview":{},"pageMetadata":{},"videoMetadata":{}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/snapchat/spotlight/comments":{"post":{"operationId":"social_snapchat_spotlight_comments","x-nexscope-slug":"social-snapchat-spotlight-comments","summary":"Snapchat Spotlight Comments by Link","description":"Fetches public comments from Snapchat's Spotlight comments API by URL. Returns the snap id, comments, a cursor for the next page, and hasMore. Pass the returned cursor back as the cursor param to load more comments. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Snapchat Spotlight Comments by Link API View Pricing Get comments from a Snapchat Spotlight URL 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Snapchat Spotlight URL."},"cursor":{"type":"string","description":"Pagination cursor from the previous response."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.snapchat.com/@lilah4823/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYY2pvZnd0ZXVmAZ8fgG8pAZ8ff-_IAAAAAQ"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"snapchat","data":{"success":true,"snapId":"W7_EDlXWTBiXAEEniNoMPwAAYY2pvZnd0ZXVmAZ8fgG8pAZ8ff-_IAAAAAQ","comments":[{"replyText":"Guys who can't even read a paragraph are hilarious \uD83D\uDE2D get yourself a better man","replyPosterDisplayName":"\uD83C\uDFB8Callie✌️","replyTimestampMs":"1782948905027","threadedReplyCount":152,"reactCounts":[{"reactTypeId":1,"reactCount":829}]}],"cursor":"CpMCEpACQ3NjQkNnZ0tBbkp6RWdJSUJBb05DZ0owY3hJSENLZjA1TW55TXhLbkFXb1hjMzVrWld4MFlTMW1iM0pqWlMxdVlXMDFMWEJ5YjJSeWl3RUxFaEJUY0c5MGJHbG5hSFJTWlhCc2FXVnpJanRYTjE5RlJHeFlWMVJDYVZoQlJVVnVhVTV2VFZCM1FVRlpXVEp3ZGxwdVpEQmFXRlp0UVZvNFptZEhPSEJCV2pobVppMWZTVUZCUVVGQlVRd0xFaEJUY0c5MGJHbG5hSFJTWlhCc2FXVnpJaVJpWkRKaU1XSTNNeTAzWkRCa0xUUXlOV010T0dKbU1DMDBNVFU1T0RneU1XSTRNekVNR0FBZ0FRPT0SgwISgAJDcjBCQ2cwS0FuUnpFZ2NJNi1LODhmUXpFcWNCYWhkemZtUmxiSFJoTFdadmNtTmxMVzVoYlRVdGNISnZaSEtMQVFzU0VGTndiM1JzYVdkb2RGSmxjR3hwWlhNaU8xYzNYMFZFYkZoWFZFSnBXRUZGUlc1cFRtOU5VSGRCUVZsWk1uQjJXbTVrTUZwWVZtMUJXamhtWjBjNGNFRmFPR1ptTFY5SlFVRkJRVUZSREFzU0VGTndiM1JzYVdkb2RGSmxjR3hwWlhNaUpEYzFNbVZqWWpObUxUSmhZMkV0TkdVM1l5MDVaakF6TFdZNFpUVm1ZVEZrTmpVNVlnd1lBQ0FC","hasMore":true},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/telegram/channel":{"post":{"operationId":"social_telegram_channel","x-nexscope-slug":"social-telegram-channel","summary":"Telegram Channel Details","description":"Retrieves public Telegram channel or group metadata including its name, description, avatar, verification status, subscriber or member count, and public media counters. This endpoint uses Telegram's public web preview and does not use a logged-in Telegram account. Private channels, invite-only groups, numeric IDs, and channels with no public web preview are not supported. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Telegram Channel Details API View Pricing Get public Telegram channel or group details from its web preview. 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Public Telegram handle, @handle, or t.me channel URL."},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["handle"],"additionalProperties":false},"example":{"handle":"telegram"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"telegram","data":{"success":true,"handle":"telegram","name":"Telegram News","description":"The official Telegram on Telegram. Much recursion. Very Telegram. Wow.","url":"https://t.me/telegram","avatar_url":"https://cdn1.telesco.pe/file/...","is_verified":true,"subscriber_count":9780000,"subscriber_count_text":"9.78M","member_count":null,"member_count_text":null,"photo_count":14,"video_count":225,"file_count":null,"link_count":372},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/telegram/channel/posts":{"post":{"operationId":"social_telegram_channel_posts","x-nexscope-slug":"social-telegram-channel-posts","summary":"Telegram Channel Posts","description":"Retrieves one public web-preview page of Telegram posts with text, publish date, views, reactions when exposed, forwards, media previews, and link previews. Pass the returned cursor to fetch the previous page. Empty and terminal pages are not charged. Telegram does not expose every field on every public post, so reactions and downloadable media URLs can be absent. This endpoint does not support private or invite-only channels and groups. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Telegram Channel Posts API View Pricing Get one page of recent public posts from a Telegram channel or group. 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Public Telegram handle, @handle, or t.me channel URL."},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"},"cursor":{"type":"string","description":"Numeric cursor returned by the previous page. Omit it for the latest posts."}},"required":["handle"],"additionalProperties":false},"example":{"handle":"durov"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"telegram","data":{"success":true,"channel":{"handle":"durov","name":"Pavel Durov","description":"Founder of Telegram.","url":"https://t.me/durov","avatar_url":"https://cdn1.telesco.pe/file/...","is_verified":true,"subscriber_count":11100000,"subscriber_count_text":"11.1M","member_count":null,"member_count_text":null,"photo_count":14,"video_count":225,"file_count":null,"link_count":372},"posts":[{"id":"543","channel_handle":"durov","url":"https://t.me/durov/543","author_name":"Pavel Durov","author_url":"https://t.me/durov","text":"Telegram has applied for the .gram domain zone. If approved, Telegram users could get their own second-level domains.","published_at":"2026-08-18T17:37:31+00:00","view_count":1210000,"view_count_text":"1.21M","reactions":[{"emoji":"⭐","emoji_id":null,"count":16300,"count_text":"16.3K"}],"reaction_count":89300,"forwarded_from":null,"media":[],"link_preview":null}],"cursor":"523","has_more":true},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/telegram/post":{"post":{"operationId":"social_telegram_post","x-nexscope-slug":"social-telegram-post","summary":"Telegram Post Details","description":"Retrieves one public Telegram post with its text, publish date, views, reactions when exposed, forward source, media previews, and link preview. This endpoint uses Telegram's public post widget without a logged-in account. Private and invite-only posts are not supported. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Telegram Post Details API View Pricing Get one public Telegram post by URL. 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Public Telegram post URL."},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://t.me/durov/543"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"telegram","data":{"success":true,"id":"543","channel_handle":"durov","url":"https://t.me/durov/543","author_name":"Pavel Durov","author_url":"https://t.me/durov","text":"Telegram has applied for the .gram domain zone. If approved, Telegram users could get their own second-level domains.","published_at":"2026-08-18T17:37:31+00:00","view_count":1210000,"view_count_text":"1.21M","reactions":[{"emoji":"⭐","emoji_id":null,"count":16300,"count_text":"16.3K"}],"reaction_count":89300,"forwarded_from":null,"media":[],"link_preview":null},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/cosmos/profile":{"post":{"operationId":"social_cosmos_profile","x-nexscope-slug":"social-cosmos-profile","summary":"Cosmos Profile","description":"Get a public Cosmos profile with bio, links, and follower counts. Public data only. One credit per successful request, including successful empty results. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Cosmos Profile API View Pricing Get a public Cosmos profile with bio, links, and follower counts. 1 credit per request\nGet a public Cosmos profile with bio, links, and follower counts. Public data only. One credit per successful request, including successful empty results.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Cosmos username without a profile URL."}},"required":["handle"],"additionalProperties":false},"example":{"handle":"design"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"cosmos","data":{"success":true,"id":234172146,"username":"design","full_name":"Design","url":"https://www.cosmos.so/design","bio":"where systems learn to speak to people","avatar_url":"https://cdn.cosmos.so/e39a4934-53ae-4536-95a3-18ccd4d052a0","website_url":null,"is_premium":true,"is_verified":false,"follower_count":744,"following_count":1,"public_post_count":25,"instagram_url":null,"twitter_url":null,"tiktok_url":null},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/cosmos/user/posts":{"post":{"operationId":"social_cosmos_user_posts","x-nexscope-slug":"social-cosmos-user-posts","summary":"Cosmos User Posts","description":"Get the public posts saved to a Cosmos user profile. Public data only. One credit per successful request, including successful empty results. Keep the cursor unchanged and stop when has_more is false. Sending cursor=null returns end_of_pagination: true and costs zero credits. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Cosmos User Posts API View Pricing Get the public posts saved to a Cosmos user profile. 1 credit per request\nGet the public posts saved to a Cosmos user profile. Public data only. One credit per successful request, including successful empty results. Keep the cursor unchanged and stop when has_more is false. Sending cursor=null returns end_of_pagination: true and costs zero credits.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Cosmos username without a profile URL."},"cursor":{"type":"string","description":"Pass the previous response cursor unchanged. Stop when it is null; sending the literal string \"null\" returns an empty terminal page without fetching or charging."}},"required":["handle"],"additionalProperties":false},"example":{"handle":"design"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"cosmos","data":{"success":true,"items":[{"id":1307496415,"url":"https://www.cosmos.so/e/1307496415","created_at":"2026-04-01T15:24:45.897845Z","caption":null,"text":null,"title":null,"description":null,"owner":{"id":14413015,"username":"esther.yang"},"source_url":null,"source_author":null,"media":[{"id":"34647529-5d71-4c17-83c1-876e5500317c","type":"StaticImage","url":"https://cdn.cosmos.so/34647529-5d71-4c17-83c1-876e5500317c","width":1440,"height":1920,"ai_generated":false,"duration":null,"thumbnail_url":null,"video_url":null,"playback_url":null}],"price":null,"brand":null}],"total_count":25,"cursor":null,"has_more":false},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/cosmos/user/clusters":{"post":{"operationId":"social_cosmos_user_clusters","x-nexscope-slug":"social-cosmos-user-clusters","summary":"Cosmos User Collections","description":"Get the public collections owned by a Cosmos user. Public data only. One credit per successful request, including successful empty results. Keep the cursor unchanged and stop when has_more is false. Sending cursor=null returns end_of_pagination: true and costs zero credits. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Cosmos User Collections API View Pricing Get the public collections owned by a Cosmos user. 1 credit per request\nGet the public collections owned by a Cosmos user. Public data only. One credit per successful request, including successful empty results. Keep the cursor unchanged and stop when has_more is false. Sending cursor=null returns end_of_pagination: true and costs zero credits.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Cosmos username without a profile URL."},"cursor":{"type":"string","description":"Pass the previous response cursor unchanged. Stop when it is null; sending the literal string \"null\" returns an empty terminal page without fetching or charging."}},"required":["handle"],"additionalProperties":false},"example":{"handle":"design"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"cosmos","data":{"success":true,"items":[{"id":957563841,"name":"the best weather apps","slug":"the-best-weather-apps","description":"some of the smartest data design on your phone","url":"https://www.cosmos.so/design/the-best-weather-apps","cover_image_url":"https://cdn.cosmos.so/fcebb83d-f089-4e17-9550-274d11c5ebd9","post_count":42,"follower_count":null,"owner":{"id":234172146,"username":"design","full_name":"Design","avatar_url":"https://cdn.cosmos.so/e39a4934-53ae-4536-95a3-18ccd4d052a0"}}],"total_count":58,"cursor":"eyJ2MSI6IjE5NzAtMDEtMDFUMDA6MDA6MDBaIiwidjIiOiIyMDI2LTA4LTI4VDE4OjM4OjMxLjc0NjM1OFoiLCJ2MyI6MTQyMTE1OTN9","has_more":true},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/cosmos/post":{"post":{"operationId":"social_cosmos_post","x-nexscope-slug":"social-cosmos-post","summary":"Cosmos Post","description":"Get a public Cosmos post with media URLs, captions, source links, and save count. Uses public Cosmos data. Private or login-restricted content is not available. Costs 1 credit per successful request, including native empty results. Scraper failures are not charged. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Cosmos Post API View Pricing Get a public Cosmos post with media URLs, captions, source links, and save count. 1 credit per request\nGet a public Cosmos post with media URLs, captions, source links, and save count. Uses public Cosmos data. Private or login-restricted content is not available. Costs 1 credit per successful request, including native empty results. Scraper failures are not charged.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Public Cosmos post URL."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.cosmos.so/e/2107587668"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"cosmos","data":{"success":true,"id":2107587668,"url":"https://www.cosmos.so/e/2107587668","created_at":"2026-01-24T17:23:49.338775Z","caption":"Japanese movie poster for A Hard Day's Night (1964) featuring The Beatles.","text":null,"title":null,"description":null,"owner":{"id":2074596056,"username":"audreyelli"},"source_url":"https://www.pinterest.com/pin/7177680652369084/","source_author":{"username":"telliott1817","full_name":"Tom Elliott","profile_url":"https://www.pinterest.com/telliott1817","avatar_url":null},"media":[{"id":"8d612bfd-2b7b-458c-ac99-af7c406eef97","type":"StaticImage","url":"https://cdn.cosmos.so/8d612bfd-2b7b-458c-ac99-af7c406eef97","width":1080,"height":1671,"ai_generated":false,"duration":null,"thumbnail_url":null,"video_url":null,"playback_url":null}],"price":null,"brand":null,"save_count":73},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/cosmos/cluster":{"post":{"operationId":"social_cosmos_cluster","x-nexscope-slug":"social-cosmos-cluster","summary":"Cosmos Collection","description":"Get a public Cosmos collection with its owner, description, cover, counts, and public subcollections. Uses public Cosmos data. Private or login-restricted content is not available. Costs 1 credit per successful request, including native empty results. Scraper failures are not charged. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Cosmos Collection API View Pricing Get a public Cosmos collection with its owner, description, cover, counts, and public subcollections. 1 credit per request\nGet a public Cosmos collection with its owner, description, cover, counts, and public subcollections. Uses public Cosmos data. Private or login-restricted content is not available. Costs 1 credit per successful request, including native empty results. Scraper failures are not charged.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Public Cosmos collection URL."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.cosmos.so/design/the-best-band-posters"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"cosmos","data":{"success":true,"id":1632840802,"name":"the best band posters","slug":"the-best-band-posters","description":"have you seen one of these in a room before?","url":"https://www.cosmos.so/design/the-best-band-posters","cover_image_url":"https://cdn.cosmos.so/images/b3964bde-a6d7-418d-91a6-09b1b7b6b9aa?rect=0,0,736,736","post_count":46,"follower_count":746,"owner":{"id":234172146,"username":"design","full_name":"Design","avatar_url":"https://cdn.cosmos.so/e39a4934-53ae-4536-95a3-18ccd4d052a0"},"subcollections":[]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/cosmos/cluster/posts":{"post":{"operationId":"social_cosmos_cluster_posts","x-nexscope-slug":"social-cosmos-cluster-posts","summary":"Cosmos Collection Posts","description":"Get public posts saved to a Cosmos collection. Supports cursor pagination. Uses public Cosmos data. Private or login-restricted content is not available. Costs 1 credit per successful request, including native empty results. Scraper failures are not charged. Sending cursor=null returns end_of_pagination: true and costs zero credits. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Cosmos Collection Posts API View Pricing Get public posts saved to a Cosmos collection. Supports cursor pagination. 1 credit per request\nGet public posts saved to a Cosmos collection. Supports cursor pagination. Uses public Cosmos data. Private or login-restricted content is not available. Costs 1 credit per successful request, including native empty results. Scraper failures are not charged. Sending cursor=null returns end_of_pagination: true and costs zero credits.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Public Cosmos collection URL."},"cursor":{"type":"string","description":"Pass the previous response cursor unchanged. Stop when it is null; sending the literal string \"null\" returns an empty terminal page without fetching or charging."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.cosmos.so/design/the-best-band-posters"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"cosmos","data":{"success":true,"items":[{"id":2107587668,"url":"https://www.cosmos.so/e/2107587668","created_at":"2026-01-24T17:23:49.338775Z","caption":"Japanese movie poster for A Hard Day's Night (1964) featuring The Beatles.","text":null,"title":null,"description":null,"owner":{"id":2074596056,"username":"audreyelli"},"source_url":"https://www.pinterest.com/pin/7177680652369084/","source_author":{"username":"telliott1817","full_name":"Tom Elliott","profile_url":"https://www.pinterest.com/telliott1817","avatar_url":null},"media":[{"id":"8d612bfd-2b7b-458c-ac99-af7c406eef97","type":"StaticImage","url":"https://cdn.cosmos.so/8d612bfd-2b7b-458c-ac99-af7c406eef97","width":1080,"height":1671,"ai_generated":false,"duration":null,"thumbnail_url":null,"video_url":null,"playback_url":null}],"price":null,"brand":null,"saved_at":"2026-10-03T02:00:48.395167Z"}],"total_count":46,"cursor":"eyJ2MSI6MTAuMCwidjIiOjE0NDU4Mzc5fQ==","has_more":true},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/cosmos/search":{"post":{"operationId":"social_cosmos_search","x-nexscope-slug":"social-cosmos-search","summary":"Cosmos Search","description":"Search public Cosmos posts by keyword. Cosmos may return related posts even when there is no exact keyword match. Public data only. One credit per successful request, including successful empty results. Keep the cursor unchanged and stop when has_more is false. result_count is Cosmos’s search retrieval-window count, not the total number of matching posts. Sending cursor=null returns end_of_pagination: true and costs zero credits. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Cosmos Search API View Pricing Search public Cosmos posts by keyword. Cosmos may return related posts even when there is no exact keyword match. 1 credit per request\nSearch public Cosmos posts by keyword. Cosmos may return related posts even when there is no exact keyword match. Public data only. One credit per successful request, including successful empty results. Keep the cursor unchanged and stop when has_more is false. result_count is Cosmos’s search retrieval-window count, not the total number of matching posts. Sending cursor=null returns end_of_pagination: true and costs zero credits.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search text."},"cursor":{"type":"string","description":"Pass the previous response cursor unchanged. Stop when it is null; sending the literal string \"null\" returns an empty terminal page without fetching or charging."}},"required":["query"],"additionalProperties":false},"example":{"query":"architecture"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"cosmos","data":{"success":true,"items":[{"id":547956585,"url":"https://www.cosmos.so/e/547956585","created_at":"2025-06-19T12:57:19.994842Z","caption":"An architectural poster created using Midjourney v7.","text":null,"title":null,"description":null,"owner":{"id":2059029120,"username":"joris.kahl"},"source_url":"https://www.instagram.com/p/DK2wZxvMsbf/?igsh=MW9ubmc3NzRucHBkNg==","source_author":{"username":"ai_architecture_awards","full_name":"AI Architecture","profile_url":"https://www.instagram.com/ai_architecture_awards","avatar_url":null},"media":[{"id":"589cdf02-9abf-4d94-88ef-809734ca5444","type":"StaticImage","url":"https://cdn.cosmos.so/e00a12d4-1e19-45de-9649-b42e9c9f724a","width":928,"height":1232,"ai_generated":false,"duration":null,"thumbnail_url":null,"video_url":null,"playback_url":null}],"price":null,"brand":null}],"cursor":"cursor://recsys/search?user_id=0&profile=search__match_jina_dual70_recql&query=architecture&last=39&count=500","has_more":true,"result_count":500},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/find-social-profiles":{"post":{"operationId":"social_find_social_profiles","x-nexscope-slug":"social-find-social-profiles","summary":"Creator Tools Find Social Profiles","description":"Accepts a supported platform and creator handle, validates both using platform-specific rules, and constructs the canonical source profile URL internally. URLs are not accepted as handles. Supported platforms are Instagram, TikTok, YouTube, X/Twitter, and Facebook; X is accepted as an alias for Twitter. YouTube accepts handles and 24-character channel IDs. The endpoint returns social profiles explicitly linked from the source profile and expands recognized link-in-bio pages. It also re-scrapes up to three supported profiles explicitly linked by the source and follows up to three unique public website URLs declared by the source or those trusted profiles for one page, while preserving each declared path and query. Generic service-provider landing pages reached through parked or unconfigured branded-domain redirects are ignored so the provider's own footer links are not attributed to the creator. It also checks whether the same handle exists on the other supported platforms. All attempted same-handle URLs are returned in same_handle_candidate_urls even when they cannot be verified strongly enough for profiles. Same-handle accounts are included in profiles only when corroborated by a shared owner-controlled website or a reciprocal profile link; matching handles and display names alone are not identity proof. same_handle_match records supporting name evidence at 0.75 confidence, while shared_website and website_link use 0.9. A bounded Google search discovers alternate handles, but Google results are never returned without verification. At most two candidates per other supported platform, up to four total, are re-scraped through that platform's profile scraper. The endpoint may also follow up to two unique recognized link-in-bio URLs declared by the re-scraped Google candidates. The global two-page cap is applied after candidates whose returned handles do not match their Google URLs are rejected. Optional profile probes and page fetches make one attempt and receive the shared enrichment abort signal. A reciprocal source-profile link found there verifies the candidate, and the page's explicit cross-platform profiles can then expand the verified identity graph. Google URLs that re-scrape to the same returned platform handle are deduplicated. A different-handle candidate is accepted only when it links back to the source profile, or when its normalized display name matches and it declares the same owner-controlled public website; common multi-tenant profile and storefront hosts are excluded from shared-website identity evidence. Google discovery uses google_search_match at 0.6, exact names use display_name_match at 0.75, reciprocal links use 0.95, and cross-platform social links explicitly declared by a verified candidate use verified_profile_link at 0.95. Source-linked URLs and failures are returned in source_linked_profile_urls and failed_source_linked_profile_urls. Google candidate URLs, candidate-declared link-in-bio URLs, verified URLs, and failures are returned in google_candidate_urls, google_candidate_link_in_bio_urls, verified_google_candidate_urls, failed_google_candidate_urls, and failed_google_candidate_link_in_bio_urls. Results are deterministic and do not use AI. Mixed or unreachable enrichment results are reported through partial and the matching failure fields. If every declared link-in-bio page fails and no other enrichment finds a profile, the request returns an uncharged 503. A successful live lookup costs 10 credits. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Creator Tools Find Social Profiles API View Pricing Find a creator's linked social profiles from a platform and handle. 10 credits per request\nAccepts a supported platform and creator handle, validates both using platform-specific rules, and constructs the canonical source profile URL internally. URLs are not accepted as handles. Supported platforms are Instagram, TikTok, YouTube, X/Twitter, and Facebook; X is accepted as an alias for Twitter. YouTube accepts handles and 24-character channel IDs. The endpoint returns social profiles explicitly linked from the source profile and expands recognized link-in-bio pages. It also re-scrapes up to three supported profiles explicitly linked by the source and follows up to three unique public website URLs declared by the source or those trusted profiles for one page, while preserving each declared path and query. Generic service-provider landing pages reached through parked or unconfigured branded-domain redirects are ignored so the provider's own footer links are not attributed to the creator. It also checks whether the same handle exists on the other supported platforms. All attempted same-handle URLs are returned in same_handle_candidate_urls even when they cannot be verified strongly enough for profiles. Same-handle accounts are included in profiles only when corroborated by a shared owner-controlled website or a reciprocal profile link; matching handles and display names alone are not identity proof. same_handle_match records supporting name evidence at 0.75 confidence, while shared_website and website_link use 0.9. A bounded Google search discovers alternate handles, but Google results are never returned without verification. At most two candidates per other supported platform, up to four total, are re-scraped through that platform's profile scraper. The endpoint may also follow up to two unique recognized link-in-bio URLs declared by the re-scraped Google candidates. The global two-page cap is applied after candidates whose returned handles do not match their Google URLs are rejected. Optional profile probes and page fetches make one attempt and receive the shared enrichment abort signal. A reciprocal source-profile link found there verifies the candidate, and the page's explicit cross-platform profiles can then expand the verified identity graph. Google URLs that re-scrape to the same returned platform handle are deduplicated. A different-handle candidate is accepted only when it links back to the source profile, or when its normalized display name matches and it declares the same owner-controlled public website; common multi-tenant profile and storefront hosts are excluded from shared-website identity evidence. Google discovery uses google_search_match at 0.6, exact names use display_name_match at 0.75, reciprocal links use 0.95, and cross-platform social links explicitly declared by a verified candidate use verified_profile_link at 0.95. Source-linked URLs and failures are returned in source_linked_profile_urls and failed_source_linked_profile_urls. Google candidate URLs, candidate-declared link-in-bio URLs, verified URLs, and failures are returned in google_candidate_urls, google_candidate_link_in_bio_urls, verified_google_candidate_urls, failed_google_candidate_urls, and failed_google_candidate_link_in_bio_urls. Results are deterministic and do not use AI. Mixed or unreachable enrichment results are reported through partial and the matching failure fields. If every declared link-in-bio page fails and no other enrichment finds a profile, the request returns an uncharged 503. A successful live lookup costs 10 credits.\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (10 credits). [See the Caching page for details.](https://docs.scrapecreators.com/caching)\nSuccessful live lookup 10 credits; cache hit 0, documented uncharged error cases as stated in operation description.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram","tiktok","youtube","x","twitter","facebook"],"description":"Source social platform"},"handle":{"type":"string","description":"Creator handle without a profile URL. A leading @ is optional."},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (10 credits). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["platform","handle"],"additionalProperties":false},"example":{"platform":"instagram","handle":"creator"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"creator-tools","data":{"success":true,"source":{"platform":"instagram","handle":"creator","url":"https://www.instagram.com/creator"},"profiles":[{"platform":"instagram","handle":"creator","url":"https://www.instagram.com/creator","confidence":1,"evidence":["source_profile"]}],"link_in_bio_urls":["https://linktr.ee/creator"],"expanded_website_urls":["https://creator.com/"],"source_linked_profile_urls":["https://x.com/creator"],"failed_source_linked_profile_urls":[],"same_handle_candidate_urls":["https://www.tiktok.com/@creator"],"partial":false,"failed_link_in_bio_urls":[],"failed_website_urls":[],"same_handle_search_partial":false,"google_search_used":true,"google_search_failed":false,"google_candidate_urls":["https://www.facebook.com/creator-page"],"google_candidate_link_in_bio_urls":["https://linktr.ee/creator"],"failed_google_candidate_link_in_bio_urls":[],"verified_google_candidate_urls":["https://www.facebook.com/creator-page"],"failed_google_candidate_urls":[],"google_verification_partial":false},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/find-creator-emails":{"post":{"operationId":"social_find_creator_emails","x-nexscope-slug":"social-find-creator-emails","summary":"Creator Tools Find Creator Emails","description":"Accepts a supported platform and creator handle, using the same verified social-profile discovery flow as Find Social Profiles. Supported starting platforms are Instagram, TikTok, YouTube, X/Twitter, and Facebook. A leading @ is optional; YouTube also accepts channel IDs. Scans publicly listed profile bios and contact links, recognized link-in-bio pages, and a bounded set of creator-declared public website pages. Other accounts are scanned only when explicitly linked or verified through reciprocal profile links or shared owner-controlled websites. Returns deduplicated email addresses with available public source URLs and source types. URLs from internal-only sources are omitted from email provenance and scan diagnostics; an email found only through those sources has an empty sources array. Partial and limited-scan flags still reflect the complete scan. Addresses may belong to the creator, their management, or a booking contact; the endpoint does not guess addresses or verify mailbox deliverability. Login-only contact details and private account data are not accessed. A successful lookup with no publicly listed email returns an empty emails array. Optional failed or timed-out scans are reported with partial results and diagnostics, so an empty partial result is not proof that no address exists. Successful live lookups cost 1 credit when emails is empty, including successful partial empty results, and 10 credits when any email is returned. Cache hits cost 0 credits. Missing or invalid inputs, missing source profiles, and failed lookups cost 0 credits. Multi-source discovery can take several seconds and may time out; retry failed requests rather than treating them as no-email results. Contact fields come from public creator pages. To request removal of your own information from Scrape Creators results, email support@scrapecreators.com with the profile URL. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Creator Tools Find Creator Emails API View Pricing Find public creator emails. Live: 1 credit with no emails, 10 credits with any email. Cache hits/failures: 0 credits. Empty or partial results do not prove no email exists. 1 credit with no emails; 10 credits with any email (live lookups)\nAccepts a supported platform and creator handle, using the same verified social-profile discovery flow as Find Social Profiles. Supported starting platforms are Instagram, TikTok, YouTube, X/Twitter, and Facebook. A leading @ is optional; YouTube also accepts channel IDs. Scans publicly listed profile bios and contact links, recognized link-in-bio pages, and a bounded set of creator-declared public website pages. Other accounts are scanned only when explicitly linked or verified through reciprocal profile links or shared owner-controlled websites. Returns deduplicated email addresses with available public source URLs and source types. URLs from internal-only sources are omitted from email provenance and scan diagnostics; an email found only through those sources has an empty sources array. Partial and limited-scan flags still reflect the complete scan. Addresses may belong to the creator, their management, or a booking contact; the endpoint does not guess addresses or verify mailbox deliverability. Login-only contact details and private account data are not accessed. A successful lookup with no publicly listed email returns an empty emails array. Optional failed or timed-out scans are reported with partial results and diagnostics, so an empty partial result is not proof that no address exists. Successful live lookups cost 1 credit when emails is empty, including successful partial empty results, and 10 credits when any email is returned. Cache hits cost 0 credits. Missing or invalid inputs, missing source profiles, and failed lookups cost 0 credits. Multi-source discovery can take several seconds and may time out; retry failed requests rather than treating them as no-email results. Contact fields come from public creator pages. To request removal of your own information from Scrape Creators results, email support@scrapecreators.com with the profile URL.\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit with no emails; 10 credits with any email (live lookups)). [See the Caching page for details.](https://docs.scrapecreators.com/caching)\nLive 1 credit if no emails, 10 if any email; cache hits and failures 0. Empty or partial results do not establish that no email exists.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram","tiktok","youtube","x","twitter","facebook"],"description":"Source social platform"},"handle":{"type":"string","description":"Creator handle without a profile URL. A leading @ is optional."},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit with no emails; 10 credits with any email (live lookups)). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["platform","handle"],"additionalProperties":false},"example":{"platform":"instagram","handle":"miguelangeles"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"creator-tools","data":{"success":true,"source":{"platform":"instagram","handle":"miguelangeles","url":"https://www.instagram.com/miguelangeles"},"emails":[{"email":"booking@amsbooking.fr","sources":[{"url":"https://www.instagram.com/miguelangeles","type":"social_profile"}]}],"scanned_profile_urls":["https://www.instagram.com/miguelangeles"],"failed_email_scan_urls":[],"email_scan_limited":true,"link_in_bio_urls":[],"expanded_website_urls":["https://irlangel.com/"],"partial":true,"failed_link_in_bio_urls":[],"failed_website_urls":[],"source_linked_profile_urls":[],"failed_source_linked_profile_urls":[],"same_handle_candidate_urls":["https://www.tiktok.com/@miguelangeles"],"same_handle_search_partial":false,"google_search_used":true,"google_search_failed":false,"google_candidate_urls":[],"google_candidate_link_in_bio_urls":[],"failed_google_candidate_link_in_bio_urls":[],"verified_google_candidate_urls":[],"failed_google_candidate_urls":[],"google_verification_partial":false},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/detect-age-gender":{"post":{"operationId":"social_detect_age_gender","x-nexscope-slug":"social-detect-age-gender","summary":"Creator Tools Get Age and Gender","description":"Uses AI to analyze a creator's profile photo and estimate their age and gender. Returns ageRange with low and high bounds, gender, and a confidence score for the gender prediction. The profile photo must contain a clear, visible face for accurate results. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Creator Tools Get Age and Gender API View Pricing Estimate a creator's age and gender from their profile photo using AI. A clear face is required for an accurate result. 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"URL to users social profile"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://twitter.com/levelsio"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"creator-tools","data":{"success":true,"ageRange":{"low":23,"high":29},"gender":"Male","confidence":{"gender":82.51082611083984}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/linktree":{"post":{"operationId":"social_linktree","x-nexscope-slug":"social-linktree","summary":"Linktree Linktree page","description":"Scrapes a Linktree page by URL, extracting the creator's profile and all their links. Returns id, username, profilePictureUrl, description, verticals, timezone, and links — an array of link objects each with id, type, title, and url. Also includes detected social accounts (instagram, tiktok, spotify, youtube, soundcloud, apple_music) and email_address. Contact fields come from the submitted public Linktree page. To request removal of your own information from Scrape Creators results, email support@scrapecreators.com with the profile URL. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Linktree Linktree page API View Pricing Linktree page 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"URL to Linktree page"},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://linktr.ee/miguelangeles"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"linktree","data":{"success":true,"id":15278008,"username":"miguelangeles","profilePictureUrl":"https://ugc.production.linktr.ee/d3141538-f586-4f3f-bc9a-a82fbebab798_DEATHRATTLE-slowed-COVER.jpeg","description":"☆☆☆☆ IRL ANGEL ☆☆☆☆\nψ EMBRACE CHAOS ψ","verticals":["music"],"linkPlatforms":["Instagram"],"timezone":"America/New_York","links":[{"id":463416775,"type":"SPOTIFY_ALBUM","title":"new project \"BEFORE THE SUN RISES & WINTERR ENDS\"","url":"https://open.spotify.com/album/0pgrg7phBbnwGJ2HBEl9EG?si=Zub7J4I3RySAaM9WVX3Okg"}],"instagram":"https://instagram.com/miguelangeles","tiktok":"https://tiktok.com/@irlangel","spotify":"https://open.spotify.com/artist/14xRX3JR8H4RWh8R7V3fvZ?si=EgRxWIPiRcaEHtSnqk5PAQ","youtube":"https://www.youtube.com/watch?v=xiFUzOJaiC4","soundcloud":"https://soundcloud.com/miguelangeles","apple_music":"https://music.apple.com/ca/artist/miguel-angeles/1209423162","email_address":"miguel@irlangel.com"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/komi":{"post":{"operationId":"social_komi","x-nexscope-slug":"social-komi","summary":"Komi Komi page","description":"Scrapes a Komi page by URL, extracting the creator's profile, social links, and featured content. Returns id, username, avatar, displayName, bio, and social accounts (instagram, tiktok, youtube, twitter, facebook, snapchat). Also includes links, an array of link and product objects each with id, url, title, type, thumbnail, and optional price and currency for products. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Komi Komi page API View Pricing Komi page 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"URL to Komi page"},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://kimkardashian.komi.io/"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"komi","data":{"success":true,"id":"64d82830-59aa-4488-bfb0-93426971d139","username":"kimkardashian","avatar":"https://komi-production-assets.s3.amazonaws.com/photos/4Nd69ODJHs61_iNYPlqos.jpg","bio":"","firstName":"Kim","lastName":"Kardashian","displayName":"Kim Kardashian","displayNameImage":null,"instagram":"https://www.instagram.com/kimkardashian/","tiktok":"https://www.tiktok.com/@kimkardashian","youtube":"https://www.youtube.com/@KUWTK","twitter":"https://twitter.com/KimKardashian","facebook":"https://www.facebook.com/KimKardashian","snapchat":"https://www.snapchat.com/add/kimkardashian?locale=en-GB","website":null,"links":[{"id":"6d7086df-ede4-4f8a-85e5-0fa410e60bc2","url":"https://skims.social/shop-skims","order":0,"title":"Visit SKIMS","visible":true,"moduleId":"e6ce39d2-e3df-4040-a5cc-ce016cacbc34","thumbnail":"https://komi-production-assets.s3-accelerate.amazonaws.com/photos/x_LQCBYzoWiel0-yrAnrF.jpg","versionId":"944094bf-f124-4b13-866a-3498c492736d","type":"LINK"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/linkbio":{"post":{"operationId":"social_linkbio","x-nexscope-slug":"social-linkbio","summary":"Linkbio Linkbio page","description":"Scrapes a Linkbio (lnk.bio) page by URL, extracting the creator's profile and all their links. Returns handle, id, social accounts (instagram, tiktok, youtube, twitter, whatsapp), email, website, and links — an array of link objects each with url and text. Contact fields come from the submitted public Linkbio page. To request removal of your own information from Scrape Creators results, email support@scrapecreators.com with the profile URL. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Linkbio Linkbio page API View Pricing Linkbio (lnk.bio) page 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"URL to Linkbio (lnk.bio) page"},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://lnk.bio/msjennafischer"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"linkbio","data":{"success":true,"handle":"msjennafischer","id":"-1154992","instagram":null,"email":null,"tiktok":null,"youtube":null,"twitter":null,"whatsapp":null,"website":null,"links":[{"url":"https://www.instagram.com/msjennafischer","text":"@msjennafischer"}]},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/amazon/shop":{"post":{"operationId":"social_amazon_shop","x-nexscope-slug":"social-amazon-shop","summary":"Amazon Shop Amazon Shop page","description":"Scrapes a creator's Amazon Shop page by URL, returning their storefront profile and product collections. The initial request also returns videos already embedded on the storefront page without requiring a pageToken. Videos include an id, title, thumbnail, and attached ASINs. Pass each returned pageToken back unchanged with the same shop URL. A paginated page can contain lists, videos, or both. Tokens are opaque: known values can begin with amzn1.ideas, amzn1.vse.video, or amzn1.shoppablemedia, but clients should not infer the response type from the prefix. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Amazon Shop Amazon Shop page API View Pricing Get products and other details from a creator's Amazon Shop page 1 credit per request\nActual supplier units are reported per request. Examples are not guaranteed prices.","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"URL to Amazon Shop page"},"pageToken":{"type":"string","description":"Opaque page token returned by a previous response for the same shop URL. Pass it back unchanged and do not infer the response type from its prefix. A page can contain lists, videos, or both."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://www.amazon.com/shop/sydneydelrey"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"amazon-shop","data":{"success":true,"avatar":"https://m.media-amazon.com/images/I/A1rW00V-tHL._CR0%2C0%2C2560%2C2560_._US500_SCLZZZZZZZ_.jpg","name":"sydney del rey","description":"sharing all of my favorite Amazon finds ᥫ᭡ click the icons below to follow me on socials! all photo & video content is also shoppable x","socials":["https://vm.tiktok.com/ZTFrowSpg/"],"lists":[{"title":"fall transition fits","itemCount":72,"image":"https://m.media-amazon.com/images/G/01/Influencer/full_bleed_pin_2x.png","url":"https://www.amazon.com/shop/sydneydelrey/list/3QCPC18WETJFQ"}],"videos":[{"id":"013f01b238c94b4f9fb63f7a35783f26","title":"So quick and simple - keep your bike from getting stolen thi","thumbnail":"https://m.media-amazon.com/images/I/81XrHZDkc7L._AC_._SX500_SCLZZZZZZZ_.jpg","asins":["B0B1ZJZRPB"]}],"trendingPicks":[{"url":"https://www.amazon.com/shop/sydneydelrey/getProductDetails/B0DDJFFCB5?showRelatedPost=true","image":"https://m.media-amazon.com/images/I/41xvQcQoEnL._AC_.jpg","price":9.99,"discount":29}],"curations":[{"title":"Fall fashion \uD83C\uDF42","postCount":93,"image":"https://m.media-amazon.com/images/S/shoppable-media-external-prod-iad-us-east-1/039230ec-2e77-4287-beca-ecba4b03ca46/8cdde-e153-4e81-b404-a1ebd6c65._SX225_SCLZZZZZZZ_.jpeg","url":"https://www.amazon.com/shop/sydneydelrey/curation/c7bb2f3d-07a2-42f5-85f8-02adbb937961"}],"pageToken":"amzn1.vse.video.0f005889de9b46f6b2499537e3ff03b0_0_2026-08-04T00:46:51.887Z"},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}},"/social/linkme":{"post":{"operationId":"social_linkme","x-nexscope-slug":"social-linkme","summary":"Linkme Profile","description":"Retrieves a Linkme profile by URL, including identity, social links, and contact details. Returns profile with id, firstName, username, bio, profileVisitCount, profileImage, verifiedAccount, and isAmbassador flag. Also includes infoLinks (email addresses) and webLinks, an array of categorized social platform links (Spotify, Instagram, YouTube, Twitter, Facebook, and more) each with linkValue and faceValue. Contact fields come from the submitted public Linkme profile. To request removal of your own information from Scrape Creators results, email support@scrapecreators.com with the profile URL. Completed lookups cost at least 10 Nexscope credits. Actual cost depends on the operation and requested options. Repeated requests may purchase data again. Linkme Profile API View Pricing Get Linkme profile info by URL 1 credit per request\nIf we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)","tags":["Social Data"],"security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SkillApiHttpStatus"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Linkme profile URL"},"cache_max_age":{"type":"string","enum":["1d","3d","7d","14d","30d"],"description":"If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with \"cached\": true and a \"cached_at\" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.](https://docs.scrapecreators.com/caching)"}},"required":["url"],"additionalProperties":false},"example":{"url":"https://link.me/danucd"}}}},"responses":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"description":"Read code, resourceStatus and usage in the response envelope.","content":{"application/json":{"schema":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{"required":["platform","resourceStatus","data","usage"],"type":"object","properties":{"platform":{"type":"string"},"data":{"type":"object"},"usage":{"type":"object"},"resourceStatus":{"type":"string"}}},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}},"example":{"data":{"platform":"linkme","data":{"success":true,"profile":{"id":"1bf3efbf94cc4f55d3650ddc61094ac3","firstName":"Dana","lastName":"","username":"danucd","verifiedAccount":0,"bio":"ALL MY LINKS\uD83D\uDC47","isAmbassador":1,"friendStatus":0,"profileVisitCount":"15.9k","isDefaultProfilePicture":false,"profileImage":"user-profile/1169288/tmp-2541-1763300314455.png","profileImageWebp":"webp-images/user-profile/1169288/tmp-2541-1763300314455.webp","isPrivate":0,"referralLink":"https://meglobalapp.page.link/TFZgPYaJGeqm3mXt5","deeplink":"https://meglobalapp.page.link/14GsZs1EQ2KMqxjH7","logo":"","logoMetaData":"","QRCode":"qrCode/v2/danucd","webTheme":"","linkmeCustomIcon":"style/icons/v5.1/LinkMe-1.png","cover":"","createdAt":"2024-11-01 12:37:51","updatedAt":"2025-11-16 13:43:17","stripeStatus":{"tipsEnabled":0,"stripeAccountId":"","stripeEnabled":false},"killer":0,"hideBottomButtons":0,"customMailForm":0,"hideAddToContacts":0,"subscriptionFeature":"","showForm":false,"subscriptionType":0,"displayNameOption":"user_name","trackingPixels":[],"isMuteEnable":0,"totalLinks":7}},"usage":{"billingStatus":"UNKNOWN"},"resourceStatus":"AVAILABLE"},"code":0,"msg":null,"ts":"0","time":"2026-01-01 00:00:00","cost":"-1","traceId":null}}}},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,{"$ref":"#/components/responses/SkillApiSemanticError"},null,{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"},{"$ref":"#/components/responses/SkillApiSemanticError"}]}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Nexscope API Key"}},"schemas":{"CommonError":{"type":"object","description":"Common API error envelope. Exact fields may vary by endpoint and upstream provider.","properties":{"code":{"oneOf":[{"type":"integer"},{"type":"string"}],"description":"Application or provider error code."},"msg":{"type":"string","description":"Error message."},"message":{"type":"string","description":"Alternative error message field."},"traceId":{"type":"string","description":"Support trace identifier when available."}},"additionalProperties":true},"SkillApiErrorEnvelope":{"required":["code","msg","data","ts","time","cost","traceId"],"type":"object","properties":{"data":{"anyOf":[{},{"type":"null"}]},"code":{"description":"0 means accepted or successful; nonzero is a platform error.","type":"integer"},"msg":{"type":["string","null"]},"ts":{"description":"Epoch milliseconds.","type":"string"},"time":{"description":"Server local time: yyyy-MM-dd HH:mm:ss.","type":"string"},"cost":{"description":"Elapsed milliseconds, never credits; -1 outside web requests.","type":"string"},"traceId":{"type":["string","null"]}}}},"responses":{"BadRequest":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommonError"}}}},"Unauthorized":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommonError"}}}},"Forbidden":{"description":"The account or API key is not allowed to use this capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommonError"}}}},"TooManyRequests":{"description":"Rate limit or account usage limit reached.","headers":{"Retry-After":{"description":"Retry delay when returned by the service.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommonError"}}}},"ServerError":{"description":"Server or upstream provider error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommonError"}}}},"SkillApiSemanticError":{"description":"Error status when X-Nexscope-Http-Status: semantic is used. Read the unchanged code/msg/data envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillApiErrorEnvelope"}}}}},"parameters":{"SkillApiHttpStatus":{"name":"X-Nexscope-Http-Status","in":"header","required":false,"description":"Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.","schema":{"default":"legacy","type":"string","enum":["legacy","semantic"]}}}},"security":[{"bearerAuth":[]}],"x-nexscope-source":"https://api.nexscope.ai/api/skill-api/v1/api-docs","x-nexscope-pricing-mode":"dynamic-credits","x-nexscope-mcp-endpoint":"https://api.nexscope.ai/api/skill-api/v1/mcp"}