Este informe ofrece datos de comerciantes para los resultados de compras de ChatGPT. group_by
selecciona una de tres vistas. merchant_share es la cuota de ofertas del comerciante.
merchant_visibility es la cuota del comerciante en las ejecuciones en las que aparece. Son
dos medidas diferentes.
Vistas
Distribución (omite group_by): una fila por cada comerciante. Métricas: merchant_share, merchant_share_rank, merchant_visibility, merchant_visibility_rank. Para obtener una serie temporal, añade date.
Cuota de marca (group_by: ["brand"]): una fila por cada comerciante y marca. Métricas: merchant_share, brand_share (la cuota de la marca en el comerciante), visibility_rank.
Productos principales (group_by: ["product"]): una fila por cada comerciante y producto. Métricas: merchant_visibility, product_visibility, product_rank.
Campos de filtro:topic, region, persona, prompt, tag. La
vista de distribución también acepta un filtro brand.
Reglas
Usa las métricas válidas para la vista. Otras métricas devuelven 422.
Agrupa por brando por product. No uses ambos.
date solo está disponible en la vista de distribución. group_by: ["brand", "date"] o ["product", "date"] devuelve 422.
El filtro brand solo está disponible en la vista de distribución.
En la vista de distribución, merchant_visibility y merchant_visibility_rank
son métricas de aparición en ejecuciones. El informe las obtiene de una segunda consulta y las añade
a cada comerciante. Solicítalas solo cuando las necesites.
Los datos de compras proceden únicamente de ChatGPT. Ningún informe de compras tiene un group_by
de model ni un filtro model.
Los informes v2 comparten una misma estructura de solicitud. Para el árbol de filtros, la agrupación y la
paginación, consulta Filtrado y conceptos.
Variante de streaming (SSE) (mismo cuerpo, /stream)
POST /v2/reports/shopping/merchants/stream usa el mismo cuerpo de solicitud.
Devuelve Server-Sent Events:
un evento summary (el bloque info) y luego un evento result por cada fila.
El stream rechaza limit y cursor. Devuelve todas las filas de forma predeterminada. Para
establecer un máximo, usa max_results (máximo 50000).
[] = distribution; [brand] = brand share within each merchant; [product] = top products per merchant. date (distribution only) adds a time series.
Opciones disponibles:
date,
brand,
product
metrics
enum<string>[] | null
Defaults to the chosen view's metrics; must be valid for that view.
Opciones disponibles:
merchant_share,
merchant_share_rank,
merchant_visibility,
merchant_visibility_rank,
visibility_rank,
brand_share,
product_visibility,
product_rank
interval
enum<string>
predeterminado:day
Opciones disponibles:
day,
week,
month
filter
FilterNode · object | null
A leaf (field/op/value) or an and/or/not group.
Show child attributes
limit
integer | null
Page size; default 10, max 50.
Rango requerido: 0 < x <= 50
max_results
integer | null
Stream endpoint only: cap streamed rows.
Rango requerido: 0 < x <= 50000
cursor
string | null
Respuesta
Successful Response
info
ShoppingMerchantsV2Info · object
requerido
Show child attributes
data
ShoppingMerchantRow · object[]
requerido
Show child attributes
¿Esta página le ayudó?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Profound","colors":{"primary":"#505050","light":"#ffffff","dark":"#000000"},"logo":{"light":"https://mintcdn.com/profound-37face47/GFG246038OVoAEi7/logo/profound-light.svg?fit=max\u0026auto=format\u0026n=GFG246038OVoAEi7\u0026q=85\u0026s=37dd421873254e856c630468bff5009f","dark":"https://mintcdn.com/profound-37face47/GFG246038OVoAEi7/logo/profound-dark.svg?fit=max\u0026auto=format\u0026n=GFG246038OVoAEi7\u0026q=85\u0026s=fbb7ed0b03bac21d149032d4ac05b63e","href":"https://www.tryprofound.com"},"favicon":{"light":"https://mintcdn.com/profound-37face47/KURP1oJG5Y6w8LYE/images/favicons/light.svg?fit=max\u0026auto=format\u0026n=KURP1oJG5Y6w8LYE\u0026q=85\u0026s=3352a1e759f49cf8de6791a40538ca90","dark":"https://mintcdn.com/profound-37face47/KURP1oJG5Y6w8LYE/images/favicons/dark.svg?fit=max\u0026auto=format\u0026n=KURP1oJG5Y6w8LYE\u0026q=85\u0026s=83a7d2990c523d7c83f87e49345717ea"},"navbar":{"links":[{"href":"https://www.tryprofound.com/blog","label":"Blog"},{"href":"mailto:support@tryprofound.com","label":"Contact"},{"href":"https://university.tryprofound.com/","label":"University"}]},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock-rotate-left","href":"https://product.tryprofound.com/changelog"},{"anchor":"Status","icon":"traffic-light","href":"https://status.tryprofound.com"}]},"languages":[{"language":"en","href":""},{"language":"es","href":"es"},{"language":"ja-jp","href":"ja-jp"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"profound-37face47","hasAudioNarration":false,"actualSubdomain":"profound-37face47","customDomains":["docs.tryprofound.com"],"gitSource":{"type":"github","owner":"cooper-square-technologies","repo":"public-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":true,"edits":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aff4d4442e7ae4824d6b77b","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"en","tag":"Platform guides","count":212},{"language":"es","tag":"Guías de la plataforma","count":212},{"language":"ja-jp","tag":"プラットフォームガイド","count":212},{"language":"en","tag":"Analytics","count":73},{"language":"es","tag":"Analítica","count":73},{"language":"ja-jp","tag":"アナリティクス","count":73},{"language":"en","tag":"Platform Configuration","count":71},{"language":"es","tag":"Configuración de la plataforma","count":71},{"language":"ja-jp","tag":"プラットフォーム設定","count":71},{"language":"en","tag":"Developer docs","count":68},{"language":"es","tag":"Documentación para desarrolladores","count":68},{"language":"ja-jp","tag":"開発者向けドキュメント","count":68},{"language":"en","tag":"AI Marketer \u0026 Agents","count":57},{"language":"es","tag":"AI Marketer y Agents","count":57},{"language":"ja-jp","tag":"AI Marketer と Agents","count":57},{"language":"en","tag":"Integrations and Connectors","count":51},{"language":"es","tag":"Integraciones y conectores","count":51},{"language":"ja-jp","tag":"インテグレーションとコネクタ","count":51},{"language":"en","tag":"Integration guides","count":49},{"language":"es","tag":"Guías de integración","count":49},{"language":"ja-jp","tag":"インテグレーションガイド","count":49},{"language":"default","tag":"Developer docs","count":40},{"language":"default","tag":"REST API \u0026 SDKs","count":40},{"language":"default","tag":"API Reference","count":40},{"language":"default","tag":"Profound API Endpoints","count":40},{"language":"en","tag":"Agents","count":37},{"language":"es","tag":"Agents","count":37},{"language":"ja-jp","tag":"Agents","count":37},{"language":"en","tag":"REST API \u0026 SDKs","count":32},{"language":"es","tag":"REST API y SDKs","count":32},{"language":"ja-jp","tag":"REST API と SDK","count":32},{"language":"en","tag":"Agent Analytics","count":31},{"language":"es","tag":"Agent Analytics","count":31},{"language":"ja-jp","tag":"Agent Analytics","count":31},{"language":"default","tag":"Categories","count":8},{"language":"default","tag":"Reports","count":8},{"language":"default","tag":"Knowledge Bases","count":7},{"language":"default","tag":"Organization","count":5},{"language":"default","tag":"Agents","count":4},{"language":"default","tag":"Prompts","count":4}],"searchSettings":{"showContentSnippets":false}},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"type":"email","email":"support@tryprofound.com"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"[data-nav-tag=\"BETA\"]{color:#92400e!important;background-color:#fef3c7!important}.dark [data-nav-tag=\"BETA\"]{color:#fde68a!important;background-color:rgba(251, 191, 36, 0.15)!important}.role-permissions-table table{table-layout:fixed;width:100%}.role-permissions-table th:first-child,.role-permissions-table td:first-child{width:34%}.role-permissions-table th,.role-permissions-table td{padding-left:0.375rem;padding-right:0.375rem;overflow-wrap:break-word}aside:has(pre),aside[class*=\"example\"],[class*=\"request-example\"],[class*=\"RequestExample\"]{position:static!important;top:auto!important;align-self:start!important;height:auto!important;max-height:none!important;overflow:visible!important}aside:has(pre) *,[class*=\"request-example\"] *,[class*=\"RequestExample\"] *{max-height:none!important}aside:has(pre) pre,[class*=\"request-example\"] pre,[class*=\"RequestExample\"] pre{max-height:none!important;height:auto!important;overflow-y:visible!important;overflow-x:auto!important}.katex-display,.katex-display>.katex,.katex-display>.katex>.katex-html{overflow:visible!important;max-height:none!important;padding:0.5rem 0}.ai-disclaimer{font-size:0.875rem;color:#6b7280}.dark .ai-disclaimer{color:#9ca3af}#navbar div:has(>#localization-select-trigger){position:absolute;right:0;top:0;height:100%;z-index:40}#navbar div:has(>nav[aria-label=\"Main\"]){padding-right:4.5rem}html[lang=\"en\"] #localization-select-trigger>span,html[lang=\"es\"] #localization-select-trigger>span{font-size:0;line-height:1}html[lang=\"en\"] #localization-select-trigger>span::after,html[lang=\"es\"] #localization-select-trigger>span::after{font-size:0.875rem;line-height:1.25rem}html[lang=\"en\"] #localization-select-trigger>span::after{content:\"EN\"}html[lang=\"es\"] #localization-select-trigger>span::after{content:\"ES\"}#navigation-items .sidebar-group-header.pf-collapsible{cursor:pointer;user-select:none;padding-right:0.75rem}#navigation-items .sidebar-group-header.pf-collapsible .pf-chevron{margin-left:auto;flex-shrink:0;color:#9ca3af;transition:transform 0.15s ease}#navigation-items .sidebar-group-header.pf-collapsible[aria-expanded=\"true\"] .pf-chevron{transform:rotate(90deg)}"}]}
{"page":{"pagePath":"es/rest-api/reports/query-shopping-merchants-v2","slug":"/es/rest-api/reports/query-shopping-merchants-v2","pageMetadata":{"title":"Comerciantes","openapi":"POST /v2/reports/shopping/merchants","tag":"Beta","description":null,"href":"/es/rest-api/reports/query-shopping-merchants-v2"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,Heading,Note}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Este informe ofrece datos de comerciantes para los resultados de compras de ChatGPT. `,_jsx(_components.code,{children:`group_by`}),`\nselecciona una de tres vistas. `,_jsx(_components.code,{children:`merchant_share`}),` es la cuota de ofertas del comerciante.\n`,_jsx(_components.code,{children:`merchant_visibility`}),` es la cuota del comerciante en las ejecuciones en las que aparece. Son\ndos medidas diferentes.`]}),`\n`,_jsx(Heading,{level:`3`,id:`vistas`,children:`Vistas`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Distribución`}),` (omite `,_jsx(_components.code,{children:`group_by`}),`): una fila por cada comerciante. Métricas: `,_jsx(_components.code,{children:`merchant_share`}),`, `,_jsx(_components.code,{children:`merchant_share_rank`}),`, `,_jsx(_components.code,{children:`merchant_visibility`}),`, `,_jsx(_components.code,{children:`merchant_visibility_rank`}),`. Para obtener una serie temporal, añade `,_jsx(_components.code,{children:`date`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Cuota de marca`}),` (`,_jsx(_components.code,{children:`group_by: [\"brand\"]`}),`): una fila por cada comerciante y marca. Métricas: `,_jsx(_components.code,{children:`merchant_share`}),`, `,_jsx(_components.code,{children:`brand_share`}),` (la cuota de la marca en el comerciante), `,_jsx(_components.code,{children:`visibility_rank`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Productos principales`}),` (`,_jsx(_components.code,{children:`group_by: [\"product\"]`}),`): una fila por cada comerciante y producto. Métricas: `,_jsx(_components.code,{children:`merchant_visibility`}),`, `,_jsx(_components.code,{children:`product_visibility`}),`, `,_jsx(_components.code,{children:`product_rank`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Campos de filtro:`}),` `,_jsx(_components.code,{children:`topic`}),`, `,_jsx(_components.code,{children:`region`}),`, `,_jsx(_components.code,{children:`persona`}),`, `,_jsx(_components.code,{children:`prompt`}),`, `,_jsx(_components.code,{children:`tag`}),`. La\nvista de distribución también acepta un filtro `,_jsx(_components.code,{children:`brand`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`reglas`,children:`Reglas`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Usa las métricas válidas para la vista. Otras métricas devuelven `,_jsx(_components.code,{children:`422`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Agrupa por `,_jsx(_components.code,{children:`brand`}),` `,_jsx(_components.strong,{children:`o`}),` por `,_jsx(_components.code,{children:`product`}),`. No uses ambos.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`date`}),` solo está disponible en la vista de distribución. `,_jsx(_components.code,{children:`group_by: [\"brand\", \"date\"]`}),` o `,_jsx(_components.code,{children:`[\"product\", \"date\"]`}),` devuelve `,_jsx(_components.code,{children:`422`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`El filtro `,_jsx(_components.code,{children:`brand`}),` solo está disponible en la vista de distribución.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`En la vista de distribución, `,_jsx(_components.code,{children:`merchant_visibility`}),` y `,_jsx(_components.code,{children:`merchant_visibility_rank`}),`\nson métricas de aparición en ejecuciones. El informe las obtiene de una segunda consulta y las añade\na cada comerciante. Solicítalas solo cuando las necesites.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Los datos de compras proceden únicamente de ChatGPT. Ningún informe de compras tiene un `,_jsx(_components.code,{children:`group_by`}),`\nde `,_jsx(_components.code,{children:`model`}),` ni un filtro `,_jsx(_components.code,{children:`model`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Los informes v2 comparten una misma estructura de solicitud. Para el árbol de filtros, la agrupación y la\npaginación, consulta `,_jsx(_components.a,{href:`/es/rest-api/reports/reports-v2-overview`,children:`Filtrado y conceptos`}),`.`]})}),`\n`,_jsx(Accordion,{title:`Variante de streaming (SSE) (mismo cuerpo, /stream)`,id:`variante-de-streaming-sse-mismo-cuerpo-stream`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`POST /v2/reports/shopping/merchants/stream`}),` usa el `,_jsx(_components.strong,{children:`mismo cuerpo de solicitud`}),`.\nDevuelve `,_jsx(_components.a,{href:`https://developer.mozilla.org/docs/Web/API/Server-sent_events`,children:`Server-Sent Events`}),`:\nun evento `,_jsx(_components.code,{children:`summary`}),` (el bloque `,_jsx(_components.code,{children:`info`}),`) y luego un evento `,_jsx(_components.code,{children:`result`}),` por cada fila.\nEl stream rechaza `,_jsx(_components.code,{children:`limit`}),` y `,_jsx(_components.code,{children:`cursor`}),`. Devuelve todas las filas de forma predeterminada. Para\nestablecer un máximo, usa `,_jsx(_components.code,{children:`max_results`}),` (máximo 50000).`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Comerciantes","openapi":"POST /v2/reports/shopping/merchants","tag":"Beta","description":null,"href":"/es/rest-api/reports/query-shopping-merchants-v2"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,CodeBlock,Heading,Note,RequestExample,ResponseExample}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Este informe ofrece datos de comerciantes para los resultados de compras de ChatGPT. `,_jsx(_components.code,{children:`group_by`}),`\nselecciona una de tres vistas. `,_jsx(_components.code,{children:`merchant_share`}),` es la cuota de ofertas del comerciante.\n`,_jsx(_components.code,{children:`merchant_visibility`}),` es la cuota del comerciante en las ejecuciones en las que aparece. Son\ndos medidas diferentes.`]}),`\n`,_jsx(Heading,{level:`3`,id:`vistas`,children:`Vistas`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Distribución`}),` (omite `,_jsx(_components.code,{children:`group_by`}),`): una fila por cada comerciante. Métricas: `,_jsx(_components.code,{children:`merchant_share`}),`, `,_jsx(_components.code,{children:`merchant_share_rank`}),`, `,_jsx(_components.code,{children:`merchant_visibility`}),`, `,_jsx(_components.code,{children:`merchant_visibility_rank`}),`. Para obtener una serie temporal, añade `,_jsx(_components.code,{children:`date`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Cuota de marca`}),` (`,_jsx(_components.code,{children:`group_by: [\"brand\"]`}),`): una fila por cada comerciante y marca. Métricas: `,_jsx(_components.code,{children:`merchant_share`}),`, `,_jsx(_components.code,{children:`brand_share`}),` (la cuota de la marca en el comerciante), `,_jsx(_components.code,{children:`visibility_rank`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Productos principales`}),` (`,_jsx(_components.code,{children:`group_by: [\"product\"]`}),`): una fila por cada comerciante y producto. Métricas: `,_jsx(_components.code,{children:`merchant_visibility`}),`, `,_jsx(_components.code,{children:`product_visibility`}),`, `,_jsx(_components.code,{children:`product_rank`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Campos de filtro:`}),` `,_jsx(_components.code,{children:`topic`}),`, `,_jsx(_components.code,{children:`region`}),`, `,_jsx(_components.code,{children:`persona`}),`, `,_jsx(_components.code,{children:`prompt`}),`, `,_jsx(_components.code,{children:`tag`}),`. La\nvista de distribución también acepta un filtro `,_jsx(_components.code,{children:`brand`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`reglas`,children:`Reglas`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Usa las métricas válidas para la vista. Otras métricas devuelven `,_jsx(_components.code,{children:`422`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Agrupa por `,_jsx(_components.code,{children:`brand`}),` `,_jsx(_components.strong,{children:`o`}),` por `,_jsx(_components.code,{children:`product`}),`. No uses ambos.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`date`}),` solo está disponible en la vista de distribución. `,_jsx(_components.code,{children:`group_by: [\"brand\", \"date\"]`}),` o `,_jsx(_components.code,{children:`[\"product\", \"date\"]`}),` devuelve `,_jsx(_components.code,{children:`422`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`El filtro `,_jsx(_components.code,{children:`brand`}),` solo está disponible en la vista de distribución.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`En la vista de distribución, `,_jsx(_components.code,{children:`merchant_visibility`}),` y `,_jsx(_components.code,{children:`merchant_visibility_rank`}),`\nson métricas de aparición en ejecuciones. El informe las obtiene de una segunda consulta y las añade\na cada comerciante. Solicítalas solo cuando las necesites.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Los datos de compras proceden únicamente de ChatGPT. Ningún informe de compras tiene un `,_jsx(_components.code,{children:`group_by`}),`\nde `,_jsx(_components.code,{children:`model`}),` ni un filtro `,_jsx(_components.code,{children:`model`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Los informes v2 comparten una misma estructura de solicitud. Para el árbol de filtros, la agrupación y la\npaginación, consulta `,_jsx(_components.a,{href:`/es/rest-api/reports/reports-v2-overview`,children:`Filtrado y conceptos`}),`.`]})}),`\n`,_jsx(Accordion,{title:`Variante de streaming (SSE) (mismo cuerpo, /stream)`,id:`variante-de-streaming-sse-mismo-cuerpo-stream`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`POST /v2/reports/shopping/merchants/stream`}),` usa el `,_jsx(_components.strong,{children:`mismo cuerpo de solicitud`}),`.\nDevuelve `,_jsx(_components.a,{href:`https://developer.mozilla.org/docs/Web/API/Server-sent_events`,children:`Server-Sent Events`}),`:\nun evento `,_jsx(_components.code,{children:`summary`}),` (el bloque `,_jsx(_components.code,{children:`info`}),`) y luego un evento `,_jsx(_components.code,{children:`result`}),` por cada fila.\nEl stream rechaza `,_jsx(_components.code,{children:`limit`}),` y `,_jsx(_components.code,{children:`cursor`}),`. Devuelve todas las filas de forma predeterminada. Para\nestablecer un máximo, usa `,_jsx(_components.code,{children:`max_results`}),` (máximo 50000).`]})}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`10`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.tryprofound.com/v2/reports/shopping/merchants`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-Key: \u003cyour-api-key>\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"category_id\": \"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"start_date\": \"2026-06-01\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"end_date\": \"2026-06-30\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"metrics\": [\"merchant_share\", \"merchant_share_rank\", \"merchant_visibility\", \"merchant_visibility_rank\"],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"limit\": 10`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`200`,numberOfLines:`22`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`22`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"info\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total_results\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`24`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"next_cursor\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"eyJvZmZzZXQiOjEwfQ==\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"view\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"distribution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"models\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ChatGPT\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"metrics\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"merchant_share\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"merchant_share_rank\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"merchant_visibility\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"merchant_visibility_rank\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"start_date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-06-01\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"end_date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-06-30\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"filter\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"merchant_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Example Retailer\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"merchant_share\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.25`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"merchant_share_rank\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"merchant_visibility\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.40`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"merchant_visibility_rank\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Comerciantes","openapi":"POST /v2/reports/shopping/merchants","tag":"Beta","description":null,"href":"/es/rest-api/reports/query-shopping-merchants-v2"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Vistas","slug":"vistas","depth":3,"children":[]},{"title":"Reglas","slug":"reglas","depth":3,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"10\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> https://api.tryprofound.com/v2/reports/shopping/merchants\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"X-API-Key: \u0026#x3C;your-api-key>\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type: application/json\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"category_id\": \"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"start_date\": \"2026-06-01\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"end_date\": \"2026-06-30\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"metrics\": [\"merchant_share\", \"merchant_share_rank\", \"merchant_visibility\", \"merchant_visibility_rank\"],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"limit\": 10\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"200","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"22\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"info\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"total_results\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">24\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"count\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">10\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"next_cursor\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"eyJvZmZzZXQiOjEwfQ==\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"view\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"distribution\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"models\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ChatGPT\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"metrics\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"merchant_share\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"merchant_share_rank\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"merchant_visibility\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"merchant_visibility_rank\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"start_date\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-06-01\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"end_date\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-06-30\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"filter\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"merchant_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Example Retailer\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"merchant_share\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0.25\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"merchant_share_rank\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"merchant_visibility\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0.40\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"merchant_visibility_rank\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}}},"jsLinks":["/_mintlify/custom/profound-37face47/8d265647b0ea078b/sidebar-collapsible-groups.js"],"openApiReferenceData":{"operation":{"tags":["Reports","Reports"],"summary":"Query Shopping Merchants V2","operationId":"query_shopping_merchants_v2_v2_reports_shopping_merchants_post","requestBody":"bbb2ce8f-b181-4bdc-92e0-c5c0fb817b72","responses":{"200":"a8d1864a-3635-4d60-af9b-7d0541fd4a93","422":"7cc6c1e6-e3dc-40fc-b774-411dc304853e"},"security":["db29a372-1e35-4a36-a091-d0561ee23b3c","7ed065f6-104d-49dc-87d4-56f16719012a"],"x-codeSamples":[{"label":"Python","lang":"Python","source":"import os\n\nfrom profound import Profound\n\nclient = Profound(\n api_key=os.environ.get(\"PROFOUND_API_KEY\"),\n)\n\nshopping = client.reports.shopping.merchants(\n category_id=\"7c9e6679-7425-40de-944b-e07fc1f90ae7\",\n start_date=\"\",\n end_date=\"\",\n interval=\"day\",\n)\n\nprint(shopping)"},{"label":"TypeScript","lang":"TypeScript","source":"import Profound from '@profoundai/client';\n\nconst client = new Profound({\n apiKey: process.env['PROFOUND_API_KEY'], // defaults to the PROFOUND_API_KEY env var\n environment: 'production',\n});\n\nconst shopping = await client.reports.shopping.merchants({\n category_id: '7c9e6679-7425-40de-944b-e07fc1f90ae7',\n start_date: '',\n end_date: '',\n interval: 'day',\n});\n\nconsole.log(shopping);"},{"label":"rust","lang":"rust","source":"use profound::*;\n\n#[tokio::main]\nasync fn main() -> Result\u003c(), Box\u003cdyn std::error::Error>> {\n let client = ProfoundClient::builder()\n .api_key(std::env::var(\"PROFOUND_API_KEY\")?)\n .build()?;\n\n let response = client\n .reports()\n .shopping()\n .merchants(ShoppingMerchantsV2Query {\n category_id: \"7c9e6679-7425-40de-944b-e07fc1f90ae7\".to_string(),\n start_date: \"\".to_string(),\n end_date: \"\".to_string(),\n group_by: None,\n metrics: None,\n interval: None,\n filter: None,\n limit: None,\n max_results: None,\n cursor: None,\n })\n .send()\n .await?;\n\n println!(\"{:?}\", response);\n\n Ok(())\n}"}],"method":"post","type":"path","servers":["fd2d7f74-a362-4675-8ec6-79dea62910ed"],"path":"/v2/reports/shopping/merchants","baseUrlOptions":["https://api.tryprofound.com"],"title":"Query Shopping Merchants V2","description":"","codeSamples":[{"label":"Python","lang":"Python","source":"import os\n\nfrom profound import Profound\n\nclient = Profound(\n api_key=os.environ.get(\"PROFOUND_API_KEY\"),\n)\n\nshopping = client.reports.shopping.merchants(\n category_id=\"7c9e6679-7425-40de-944b-e07fc1f90ae7\",\n start_date=\"\",\n end_date=\"\",\n interval=\"day\",\n)\n\nprint(shopping)"},{"label":"TypeScript","lang":"TypeScript","source":"import Profound from '@profoundai/client';\n\nconst client = new Profound({\n apiKey: process.env['PROFOUND_API_KEY'], // defaults to the PROFOUND_API_KEY env var\n environment: 'production',\n});\n\nconst shopping = await client.reports.shopping.merchants({\n category_id: '7c9e6679-7425-40de-944b-e07fc1f90ae7',\n start_date: '',\n end_date: '',\n interval: 'day',\n});\n\nconsole.log(shopping);"},{"label":"rust","lang":"rust","source":"use profound::*;\n\n#[tokio::main]\nasync fn main() -> Result\u003c(), Box\u003cdyn std::error::Error>> {\n let client = ProfoundClient::builder()\n .api_key(std::env::var(\"PROFOUND_API_KEY\")?)\n .build()?;\n\n let response = client\n .reports()\n .shopping()\n .merchants(ShoppingMerchantsV2Query {\n category_id: \"7c9e6679-7425-40de-944b-e07fc1f90ae7\".to_string(),\n start_date: \"\".to_string(),\n end_date: \"\".to_string(),\n group_by: None,\n metrics: None,\n interval: None,\n filter: None,\n limit: None,\n max_results: None,\n cursor: None,\n })\n .send()\n .await?;\n\n println!(\"{:?}\", response);\n\n Ok(())\n}"}],"requiredOnlyExamples":false,"requestExamples":[{"dropdown":false,"language":"shellscript","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"shellscript","children":{"type":"code","key":null,"ref":null,"props":{"language":"shellscript","numberOfLines":"10","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#953800","--shiki-dark":"#DCDCAA"},"children":"curl"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":" -X"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" POST"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" https://api.tryprofound.com/v2/reports/shopping/merchants"}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D7BA7D"},"children":" \\"}}]}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":" -H"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"X-API-Key: \u003cyour-api-key>\""}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D7BA7D"},"children":" \\"}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":" -H"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"Content-Type: application/json\""}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D7BA7D"},"children":" \\"}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":" -d"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" '{"}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"category_id\": \"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\","}}}},"\n",{"type":"span","key":"10","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"start_date\": \"2026-06-01\","}}}},"\n",{"type":"span","key":"12","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"end_date\": \"2026-06-30\","}}}},"\n",{"type":"span","key":"14","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"metrics\": [\"merchant_share\", \"merchant_share_rank\", \"merchant_visibility\", \"merchant_visibility_rank\"],"}}}},"\n",{"type":"span","key":"16","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"limit\": 10"}}}},"\n",{"type":"span","key":"18","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" }'"}}}},"\n"]}}}},"filename":"cURL"}],"requestExampleType":"mdx","responseExamples":[{"dropdown":false,"language":"json","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"json","children":{"type":"code","key":null,"ref":null,"props":{"language":"json","numberOfLines":"22","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}}}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"info\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": {"}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"total_results\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#B5CEA8"},"children":"24"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"count\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#B5CEA8"},"children":"10"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"next_cursor\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"eyJvZmZzZXQiOjEwfQ==\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"10","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"view\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"distribution\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"12","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"models\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": ["}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"ChatGPT\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"],"}}]}},"\n",{"type":"span","key":"14","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"metrics\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": ["}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"merchant_share\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":", "}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"merchant_share_rank\""}},{"type":"span","key":"5","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":", "}},{"type":"span","key":"6","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"merchant_visibility\""}},{"type":"span","key":"7","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":", "}},{"type":"span","key":"8","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"merchant_visibility_rank\""}},{"type":"span","key":"9","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"],"}}]}},"\n",{"type":"span","key":"16","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"start_date\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"2026-06-01\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"18","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"end_date\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"2026-06-30\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"20","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"filter\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":"null"}}]}},"\n",{"type":"span","key":"22","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" },"}}}},"\n",{"type":"span","key":"24","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"data\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": ["}}]}},"\n",{"type":"span","key":"26","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" {"}}}},"\n",{"type":"span","key":"28","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"merchant_name\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"Example Retailer\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"30","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"merchant_share\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#B5CEA8"},"children":"0.25"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"32","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"merchant_share_rank\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#B5CEA8"},"children":"1"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"34","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"merchant_visibility\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#B5CEA8"},"children":"0.40"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"36","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"merchant_visibility_rank\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#B5CEA8"},"children":"1"}}]}},"\n",{"type":"span","key":"38","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" }"}}}},"\n",{"type":"span","key":"40","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" ]"}}}},"\n",{"type":"span","key":"42","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"}"}}}},"\n"]}}}},"filename":"200"}],"responseExampleType":"mdx"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"category_id":{"type":"string","format":"uuid","title":"Category Id","isRequired":true,"uniqueKey":"category_id","typeLabel":"string\u003cuuid>"},"start_date":{"type":"string","title":"Start Date","description":"YYYY-MM-DD, ET, inclusive","isRequired":true,"uniqueKey":"start_date","typeLabel":"string"},"end_date":{"type":"string","title":"End Date","description":"YYYY-MM-DD, ET, inclusive","isRequired":true,"uniqueKey":"end_date","typeLabel":"string"},"group_by":{"items":{"type":"string","enum":["date","brand","product"],"uniqueKey":"group_by.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","title":"Group By","description":"`[]` = distribution; `[brand]` = brand share within each merchant; `[product]` = top products per merchant. `date` (distribution only) adds a time series.","uniqueKey":"group_by","typeLabel":"enum\u003cstring>[]"},"metrics":{"oneOf":[{"type":"array","items":{"type":"string","enum":["merchant_share","merchant_share_rank","merchant_visibility","merchant_visibility_rank","visibility_rank","brand_share","product_visibility","product_rank"],"uniqueKey":"metrics.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"title":"Metrics","description":"Defaults to the chosen view's metrics; must be valid for that view.","uniqueKey":"metrics.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","title":"Metrics","description":"Defaults to the chosen view's metrics; must be valid for that view.","uniqueKey":"metrics.oneOf.1","typeLabel":"null"}],"uniqueKey":"metrics","typeLabel":"enum\u003cstring>[] | null"},"interval":{"type":"string","enum":["day","week","month"],"title":"Interval","default":"day","uniqueKey":"interval","typeLabel":"enum\u003cstring>"},"filter":{"oneOf":[{"type":"object","title":"FilterNode","description":"A leaf (`field`/`op`/`value`) or an `and`/`or`/`not` group.","properties":{"and":{"oneOf":[{"type":"array","items":{"oneOf":[{}],"uniqueKey":"filter.oneOf.0.and.oneOf.0.items.[INDEX]","typeLabel":"any"},"title":"And","uniqueKey":"filter.oneOf.0.and.oneOf.0","typeLabel":"any[]"},{"type":"null","title":"And","uniqueKey":"filter.oneOf.0.and.oneOf.1","typeLabel":"null"}],"uniqueKey":"filter.oneOf.0.and","typeLabel":"any[] | null"},"or":{"oneOf":[{"type":"array","items":{"oneOf":[{}],"uniqueKey":"filter.oneOf.0.or.oneOf.0.items.[INDEX]","typeLabel":"any"},"title":"Or","uniqueKey":"filter.oneOf.0.or.oneOf.0","typeLabel":"any[]"},{"type":"null","title":"Or","uniqueKey":"filter.oneOf.0.or.oneOf.1","typeLabel":"null"}],"uniqueKey":"filter.oneOf.0.or","typeLabel":"any[] | null"},"not":{"oneOf":[{},{"type":"null","uniqueKey":"filter.oneOf.0.not.oneOf.1","typeLabel":"null"}],"uniqueKey":"filter.oneOf.0.not","typeLabel":"null"},"field":{"oneOf":[{"type":"string","title":"Field","uniqueKey":"filter.oneOf.0.field.oneOf.0","typeLabel":"string"},{"type":"null","title":"Field","uniqueKey":"filter.oneOf.0.field.oneOf.1","typeLabel":"null"}],"uniqueKey":"filter.oneOf.0.field","typeLabel":"string | null"},"op":{"oneOf":[{"type":"string","title":"Op","uniqueKey":"filter.oneOf.0.op.oneOf.0","typeLabel":"string"},{"type":"null","title":"Op","uniqueKey":"filter.oneOf.0.op.oneOf.1","typeLabel":"null"}],"uniqueKey":"filter.oneOf.0.op","typeLabel":"string | null"},"value":{"oneOf":[{"title":"Value"}],"uniqueKey":"filter.oneOf.0.value","typeLabel":"any"}},"additionalProperties":false,"uniqueKey":"filter.oneOf.0","typeLabel":"FilterNode · object"},{"type":"null","uniqueKey":"filter.oneOf.1","typeLabel":"null"}],"uniqueKey":"filter","typeLabel":"FilterNode · object | null"},"limit":{"oneOf":[{"type":"integer","title":"Limit","description":"Page size; default 10, max 50.","maximum":50,"minimum":0,"exclusiveMinimum":true,"uniqueKey":"limit.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Limit","description":"Page size; default 10, max 50.","uniqueKey":"limit.oneOf.1","typeLabel":"null"}],"uniqueKey":"limit","typeLabel":"integer | null"},"max_results":{"oneOf":[{"type":"integer","title":"Max Results","description":"Stream endpoint only: cap streamed rows.","maximum":50000,"minimum":0,"exclusiveMinimum":true,"uniqueKey":"max_results.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Max Results","description":"Stream endpoint only: cap streamed rows.","uniqueKey":"max_results.oneOf.1","typeLabel":"null"}],"uniqueKey":"max_results","typeLabel":"integer | null"},"cursor":{"oneOf":[{"type":"string","title":"Cursor","uniqueKey":"cursor.oneOf.0","typeLabel":"string"},{"type":"null","title":"Cursor","uniqueKey":"cursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"cursor","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["category_id","start_date","end_date"],"title":"ShoppingMerchantsV2Query","uniqueKey":"","typeLabel":"ShoppingMerchantsV2Query · object"},"examples":{"Example":{"title":"Example","value":{"category_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","start_date":"\u003cstring>","end_date":"\u003cstring>","group_by":[],"metrics":[],"interval":"day","filter":{"and":["\u003cunknown>"],"or":["\u003cunknown>"],"not":"\u003cunknown>","field":"\u003cstring>","op":"\u003cstring>","value":"\u003cunknown>"},"limit":25,"max_results":25000,"cursor":"\u003cstring>"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"a8d1864a-3635-4d60-af9b-7d0541fd4a93":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"info":{"properties":{"count":{"type":"integer","title":"Count","description":"Number of rows returned in `data` for this page.","isRequired":true,"uniqueKey":"info.count","typeLabel":"integer"},"models":{"items":{"type":"string","uniqueKey":"info.models.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Models","description":"Display names of the models the report covers.","isRequired":true,"uniqueKey":"info.models","typeLabel":"string[]"},"start_date":{"type":"string","title":"Start Date","description":"Echoed request start date (YYYY-MM-DD, ET).","isRequired":true,"uniqueKey":"info.start_date","typeLabel":"string"},"end_date":{"type":"string","title":"End Date","description":"Echoed request end date (YYYY-MM-DD, ET).","isRequired":true,"uniqueKey":"info.end_date","typeLabel":"string"},"view":{"type":"string","title":"View","description":"`distribution`, `brand_share`, or `top_products`.","isRequired":true,"uniqueKey":"info.view","typeLabel":"string"},"metrics":{"items":{"type":"string","uniqueKey":"info.metrics.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Metrics","description":"Metrics returned per row.","isRequired":true,"uniqueKey":"info.metrics","typeLabel":"string[]"},"total_results":{"oneOf":[{"type":"integer","title":"Total Results","description":"Total rows matching the query before pagination (null when not computed).","uniqueKey":"info.total_results.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Total Results","description":"Total rows matching the query before pagination (null when not computed).","uniqueKey":"info.total_results.oneOf.1","typeLabel":"null"}],"uniqueKey":"info.total_results","typeLabel":"integer | null"},"next_cursor":{"oneOf":[{"type":"string","title":"Next Cursor","description":"Opaque cursor for the next page; null on the last page.","uniqueKey":"info.next_cursor.oneOf.0","typeLabel":"string"},{"type":"null","title":"Next Cursor","description":"Opaque cursor for the next page; null on the last page.","uniqueKey":"info.next_cursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"info.next_cursor","typeLabel":"string | null"},"filter":{"oneOf":[{"type":"object","title":"Filter","description":"Echoed normalized filter tree, or null when no filter was sent.","additionalProperties":true,"uniqueKey":"info.filter.oneOf.0","typeLabel":"Filter · object"},{"type":"null","title":"Filter","description":"Echoed normalized filter tree, or null when no filter was sent.","uniqueKey":"info.filter.oneOf.1","typeLabel":"null"}],"uniqueKey":"info.filter","typeLabel":"Filter · object | null"}},"additionalProperties":true,"type":"object","required":["count","models","start_date","end_date","view","metrics"],"title":"ShoppingMerchantsV2Info","isRequired":true,"uniqueKey":"info","typeLabel":"ShoppingMerchantsV2Info · object"},"data":{"items":{"properties":{"merchant_name":{"oneOf":[{"type":"string","title":"Merchant Name","uniqueKey":"data.items.[INDEX].merchant_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Merchant Name","uniqueKey":"data.items.[INDEX].merchant_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].merchant_name","typeLabel":"string | null"},"merchant_share":{"oneOf":[{"type":"number","title":"Merchant Share","uniqueKey":"data.items.[INDEX].merchant_share.oneOf.0","typeLabel":"number"},{"type":"null","title":"Merchant Share","uniqueKey":"data.items.[INDEX].merchant_share.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].merchant_share","typeLabel":"number | null"},"merchant_share_rank":{"oneOf":[{"type":"integer","title":"Merchant Share Rank","uniqueKey":"data.items.[INDEX].merchant_share_rank.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Merchant Share Rank","uniqueKey":"data.items.[INDEX].merchant_share_rank.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].merchant_share_rank","typeLabel":"integer | null"},"merchant_visibility":{"oneOf":[{"type":"number","title":"Merchant Visibility","uniqueKey":"data.items.[INDEX].merchant_visibility.oneOf.0","typeLabel":"number"},{"type":"null","title":"Merchant Visibility","uniqueKey":"data.items.[INDEX].merchant_visibility.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].merchant_visibility","typeLabel":"number | null"},"merchant_visibility_rank":{"oneOf":[{"type":"integer","title":"Merchant Visibility Rank","uniqueKey":"data.items.[INDEX].merchant_visibility_rank.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Merchant Visibility Rank","uniqueKey":"data.items.[INDEX].merchant_visibility_rank.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].merchant_visibility_rank","typeLabel":"integer | null"},"date":{"oneOf":[{"type":"string","title":"Date","uniqueKey":"data.items.[INDEX].date.oneOf.0","typeLabel":"string"},{"type":"null","title":"Date","uniqueKey":"data.items.[INDEX].date.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].date","typeLabel":"string | null"},"visibility_rank":{"oneOf":[{"type":"integer","title":"Visibility Rank","uniqueKey":"data.items.[INDEX].visibility_rank.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Visibility Rank","uniqueKey":"data.items.[INDEX].visibility_rank.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].visibility_rank","typeLabel":"integer | null"},"brand_name":{"oneOf":[{"type":"string","title":"Brand Name","uniqueKey":"data.items.[INDEX].brand_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Brand Name","uniqueKey":"data.items.[INDEX].brand_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].brand_name","typeLabel":"string | null"},"brand_share":{"oneOf":[{"type":"number","title":"Brand Share","uniqueKey":"data.items.[INDEX].brand_share.oneOf.0","typeLabel":"number"},{"type":"null","title":"Brand Share","uniqueKey":"data.items.[INDEX].brand_share.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].brand_share","typeLabel":"number | null"},"product":{"oneOf":[{"type":"object","title":"Product","additionalProperties":true,"uniqueKey":"data.items.[INDEX].product.oneOf.0","typeLabel":"Product · object"},{"type":"null","title":"Product","uniqueKey":"data.items.[INDEX].product.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].product","typeLabel":"Product · object | null"},"product_visibility":{"oneOf":[{"type":"number","title":"Product Visibility","uniqueKey":"data.items.[INDEX].product_visibility.oneOf.0","typeLabel":"number"},{"type":"null","title":"Product Visibility","uniqueKey":"data.items.[INDEX].product_visibility.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].product_visibility","typeLabel":"number | null"},"product_rank":{"oneOf":[{"type":"integer","title":"Product Rank","uniqueKey":"data.items.[INDEX].product_rank.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Product Rank","uniqueKey":"data.items.[INDEX].product_rank.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].product_rank","typeLabel":"integer | null"}},"additionalProperties":true,"type":"object","title":"ShoppingMerchantRow","description":"One merchant row. `brand_name`/`brand_share` appear in the brand-share view; `product`/product\nmetrics in the top-products view; metrics vary by view.","uniqueKey":"data.items.[INDEX]","typeLabel":"ShoppingMerchantRow · object"},"type":"array","title":"Data","isRequired":true,"uniqueKey":"data","typeLabel":"ShoppingMerchantRow · object[]"}},"type":"object","required":["info","data"],"title":"ShoppingMerchantsV2Response","uniqueKey":"","typeLabel":"ShoppingMerchantsV2Response · object"},"examples":{"Example":{"title":"Example","value":{"info":{"count":123,"models":["\u003cstring>"],"start_date":"\u003cstring>","end_date":"\u003cstring>","view":"\u003cstring>","metrics":["\u003cstring>"],"total_results":123,"next_cursor":"\u003cstring>","filter":{}},"data":[{"merchant_name":"\u003cstring>","merchant_share":123,"merchant_share_rank":123,"merchant_visibility":123,"merchant_visibility_rank":123,"date":"\u003cstring>","visibility_rank":123,"brand_name":"\u003cstring>","brand_share":123,"product":{},"product_visibility":123,"product_rank":123}]}}},"exampleType":"generated"}},"exampleType":"generated"},"7cc6c1e6-e3dc-40fc-b774-411dc304853e":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"db29a372-1e35-4a36-a091-d0561ee23b3c":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[]}},"7ed065f6-104d-49dc-87d4-56f16719012a":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]}}},"servers":{"fd2d7f74-a362-4675-8ec6-79dea62910ed":{"url":"https://api.tryprofound.com","description":"Production Server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[]},"schema":{"title":"X-API-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKeyHeader","name":"X-API-Key"}],"title":"APIKeyHeader"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed"},"subdomain":"profound-37face47","siteName":"Profound","title":"Comerciantes - Profound","relatedPagesConfig":{"enabled":false,"limit":5,"mode":"automatic"},"contextualStarterQuestions":[{"_id":"6ac3c81a935808ca1fd424bd","deploymentId":"6753b750487e67e4ea1247ee","questionText":"¿Cómo filtro por marca?","status":"active","generatedBy":"contextual","path":"es/rest-api/reports/query-shopping-merchants-v2","createdAt":"2026-10-05T15:54:02.626Z","updatedAt":"2026-10-05T15:54:02.626Z","__v":0},{"_id":"6ac3c81a935808ca1fd424bb","deploymentId":"6753b750487e67e4ea1247ee","questionText":"¿Cuáles son las tres vistas?","status":"active","generatedBy":"contextual","path":"es/rest-api/reports/query-shopping-merchants-v2","createdAt":"2026-10-05T15:54:02.626Z","updatedAt":"2026-10-05T15:54:02.626Z","__v":0},{"_id":"6ac3c81a935808ca1fd424bc","deploymentId":"6753b750487e67e4ea1247ee","questionText":"¿Qué métricas debo usar?","status":"active","generatedBy":"contextual","path":"es/rest-api/reports/query-shopping-merchants-v2","createdAt":"2026-10-05T15:54:02.626Z","updatedAt":"2026-10-05T15:54:02.626Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/rest-api/reports/query-shopping-merchants-v2","matchLevel":1},"es":{"href":"/es/rest-api/reports/query-shopping-merchants-v2","matchLevel":0},"ja-jp":{"href":"/ja-jp/rest-api/reports/query-shopping-merchants-v2","matchLevel":1}}},"lastModified":"2026-11-12T19:37:24.472Z","originalFileLocation":"es/rest-api/reports/query-shopping-merchants-v2.mdx","locale":"es"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Profound\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/profound-37face47/Q1dMJpKvzw6s9pGb/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/profound-37face47/Q1dMJpKvzw6s9pGb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/profound-37face47/Q1dMJpKvzw6s9pGb/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/profound-37face47/Q1dMJpKvzw6s9pGb/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/profound-37face47/Q1dMJpKvzw6s9pGb/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/profound-37face47/Q1dMJpKvzw6s9pGb/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/profound-37face47/Q1dMJpKvzw6s9pGb/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/profound-37face47/Q1dMJpKvzw6s9pGb/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/profound-37face47/Q1dMJpKvzw6s9pGb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Comerciantes - Profound\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Profound\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tryprofound.com/es/rest-api/reports/query-shopping-merchants-v2\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://profound-37face47.mintlify.site/_mintlify/api/og/v2?division=Compras\u0026amp;title=Comerciantes\u0026amp;theme=33a972325390d9500c45c160\u0026amp;signature=41ef682fc36f424371117e0a15f066e258c2cb8a3908f02b29f2d494a0a21262\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Comerciantes - Profound\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://profound-37face47.mintlify.site/_mintlify/api/og/v2?division=Compras\u0026amp;title=Comerciantes\u0026amp;theme=33a972325390d9500c45c160\u0026amp;signature=41ef682fc36f424371117e0a15f066e258c2cb8a3908f02b29f2d494a0a21262\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/profound-37face47/Q1dMJpKvzw6s9pGb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Profound\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#505050\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tryprofound.com/es/rest-api/reports/query-shopping-merchants-v2\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/es/rest-api/reports/query-shopping-merchants-v2.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.tryprofound.com/es/rest-api/reports/query-shopping-merchants-v2\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.tryprofound.com/rest-api/reports/query-shopping-merchants-v2\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja-JP\" href=\"https://docs.tryprofound.com/ja-jp/rest-api/reports/query-shopping-merchants-v2\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.tryprofound.com/rest-api/reports/query-shopping-merchants-v2\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tryprofound.com/#organization\",\"name\":\"Profound\",\"url\":\"https://docs.tryprofound.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/profound-37face47/GFG246038OVoAEi7/logo/profound-light.svg?fit=max\u0026auto=format\u0026n=GFG246038OVoAEi7\u0026q=85\u0026s=37dd421873254e856c630468bff5009f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tryprofound.com#website\",\"name\":\"Profound\",\"url\":\"https://docs.tryprofound.com\",\"publisher\":{\"@id\":\"https://docs.tryprofound.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tryprofound.com/es/rest-api/reports/query-shopping-merchants-v2#webpage\",\"url\":\"https://docs.tryprofound.com/es/rest-api/reports/query-shopping-merchants-v2\",\"name\":\"Comerciantes\",\"dateModified\":\"2026-11-12T19:37:24.472Z\",\"isPartOf\":{\"@id\":\"https://docs.tryprofound.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tryprofound.com/es/rest-api/reports/query-shopping-merchants-v2#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tryprofound.com/es/rest-api/reports/query-shopping-merchants-v2#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Referencia de la API\",\"item\":\"https://docs.tryprofound.com/api-reference/agents/list-agents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Endpoints de la API de Profound\",\"item\":\"https://docs.tryprofound.com/api-reference/agents/list-agents\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Informes\",\"item\":\"https://docs.tryprofound.com/es/rest-api/reports/reports-v2-overview\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Informes v2\",\"item\":\"https://docs.tryprofound.com/es/rest-api/reports/reports-v2-overview\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Compras\",\"item\":\"https://docs.tryprofound.com/es/rest-api/reports/query-shopping-brands-v2\"},{\"@type\":\"ListItem\",\"position\":6,\"name\":\"Comerciantes\",\"item\":\"https://docs.tryprofound.com/es/rest-api/reports/query-shopping-merchants-v2\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.tryprofound.com/es/rest-api/reports/query-shopping-merchants-v2#apireference\",\"headline\":\"Comerciantes\",\"name\":\"Comerciantes\",\"url\":\"https://docs.tryprofound.com/es/rest-api/reports/query-shopping-merchants-v2\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tryprofound.com/es/rest-api/reports/query-shopping-merchants-v2#webpage\"},\"dateModified\":\"2026-11-12T19:37:24.472Z\",\"publisher\":{\"@id\":\"https://docs.tryprofound.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tryprofound.com#website\"}}]}\u003c/script>","agentPointerHref":"/es/rest-api/reports/query-shopping-merchants-v2.md","siteName":"Profound","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock-rotate-left","href":"https://product.tryprofound.com/changelog"},{"anchor":"Status","icon":"traffic-light","href":"https://status.tryprofound.com"}]},"languages":[{"language":"en","pages":[{"title":"en","href":"/rest-api/reports/query-shopping-merchants-v2"}]},{"language":"es","products":[{"product":"Guías de la plataforma","icon":"layer-group","description":"Productos, funciones y configuración de Profound","pages":[{"title":"Guías de la plataforma","href":"/es"}]},{"product":"Documentación para desarrolladores","icon":"code","description":"REST API, SDKs y servidor MCP","tabs":[{"tab":"Inicio","pages":[{"title":"Inicio","href":"/es"}]},{"tab":"REST API y SDKs","groups":[{"group":"Primeros pasos","icon":"rocket","pages":[{"title":"Introducción","href":"/es/rest-api/introduction"},{"title":"Autenticación","href":"/es/rest-api/authentication"},{"title":"Rangos de fechas y zonas horarias","href":"/es/rest-api/date-ranges"},{"title":"Formato de respuesta","href":"/es/rest-api/response-format"},{"title":"Registro de cambios","href":"/es/rest-api/changelog"}]},{"group":"Referencia de la API","icon":"code","pages":[{"group":"Endpoints de la API de Profound","pages":[{"group":"Agentes","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/agents","href":"/api-reference/agents/list-agents"},{"title":"Get an agent","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/agents/{agent_id}","href":"/api-reference/agents/get-an-agent"},{"title":"Run an agent","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed post /v1/agents/{agent_id}/runs","href":"/api-reference/agents/run-an-agent"},{"title":"Get an agent run","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/agents/{agent_id}/runs/{run_id}","href":"/api-reference/agents/get-an-agent-run"}]},{"group":"Respuestas","pages":[{"group":"Respuestas v2","tag":"Beta","pages":[{"title":"Obtener respuestas","openapi":"POST /v2/prompts/answers","href":"/es/rest-api/reports/query-answers-v2"}]},{"group":"Respuestas v1","pages":[{"title":"Get Answers","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed post /v1/prompts/answers","href":"/api-reference/prompts/get-answers"}]}]},{"group":"Categorías","pages":[{"title":"Get Categories","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/org/categories","href":"/api-reference/organization/get-categories"},{"title":"Get Category Topics","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/org/categories/{category_id}/topics","href":"/api-reference/organization/get-category-topics"},{"title":"Get Category Tags","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/org/categories/{category_id}/tags","href":"/api-reference/organization/get-category-tags"},{"title":"Get Category Regions","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/org/categories/{category_id}/regions","href":"/api-reference/organization/get-category-regions"},{"title":"Get Category Assets","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/org/categories/{category_id}/assets","href":"/api-reference/organization/get-category-assets"},{"title":"Get Category Personas","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/org/categories/{category_id}/personas","href":"/api-reference/organization/get-category-personas"},{"title":"Get Category Citation Categories","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/org/categories/{category_id}/citation-categories","href":"/api-reference/organization/get-category-citation-categories"},{"title":"Get Category Citation Tags","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/org/categories/{category_id}/citation-tags","href":"/api-reference/organization/get-category-citation-tags"}]},{"group":"Optimización de contenido","pages":[{"title":"Optimization List","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/content/{asset_id}/optimization","href":"/api-reference/content/optimization-list"},{"title":"Optimization Analysis","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/content/{asset_id}/optimization/{content_id}","href":"/api-reference/content/optimization-analysis"}]},{"group":"Bases de conocimiento","pages":[{"title":"List Knowledge Bases","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/knowledge-bases","href":"/api-reference/knowledge-bases/list-knowledge-bases"},{"title":"Search Knowledge Base","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed post /v1/knowledge-bases/{knowledge_base_id}/search","href":"/api-reference/knowledge-bases/search-knowledge-base"},{"title":"Add Document","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed post /v1/knowledge-bases/{knowledge_base_id}/documents","href":"/api-reference/knowledge-bases/add-document"},{"title":"Update Document","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed put /v1/knowledge-bases/{knowledge_base_id}/documents","href":"/api-reference/knowledge-bases/update-document"},{"title":"Delete Document","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed delete /v1/knowledge-bases/{knowledge_base_id}/documents","href":"/api-reference/knowledge-bases/delete-document"},{"title":"Add Folder","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed post /v1/knowledge-bases/{knowledge_base_id}/folders","href":"/api-reference/knowledge-bases/add-folder"},{"title":"Delete Folder","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed delete /v1/knowledge-bases/{knowledge_base_id}/folders","href":"/api-reference/knowledge-bases/delete-folder"}]},{"group":"Anuncios de OpenAI","tag":"Beta","pages":[{"title":"Get Account Insights","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/ads/openai-ads/ad-account/insights","href":"/api-reference/openai-ads/get-account-insights"}]},{"group":"Organización","pages":[{"title":"Get Regions","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/org/regions","href":"/api-reference/organization/get-regions"},{"title":"Get Models","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/org/models","href":"/api-reference/organization/get-models"},{"title":"Get Domains","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/org/domains","href":"/api-reference/organization/get-domains"},{"title":"Get Assets","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/org/assets","href":"/api-reference/organization/get-assets"},{"title":"Get Personas","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/org/personas","href":"/api-reference/organization/get-personas"}]},{"group":"Prompts","pages":[{"title":"List prompts","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed get /v1/org/categories/{category_id}/prompts","href":"/api-reference/organization/list-prompts"},{"title":"Create prompts","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed post /v1/org/categories/{category_id}/prompts","href":"/api-reference/organization/create-prompts"},{"title":"Update prompts","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed patch /v1/org/categories/{category_id}/prompts","href":"/api-reference/organization/update-prompts"},{"title":"Update prompt status","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed patch /v1/org/categories/{category_id}/prompts/status","href":"/api-reference/organization/update-prompt-status"}]},{"group":"Volúmenes de prompts","pages":[{"title":"Volumen de palabras clave","openapi":"POST /v2/prompt-volumes/volume/on-the-fly","href":"/es/rest-api/prompt-volumes/query-volume-v2"},{"title":"Distribución de intenciones por palabra clave","openapi":"POST /v2/prompt-volumes/intents/on-the-fly","href":"/es/rest-api/prompt-volumes/query-intents-v2"}]},{"group":"Informes","pages":[{"group":"Informes v2","tag":"Beta","pages":[{"title":"Filtrado y conceptos","href":"/es/rest-api/reports/reports-v2-overview"},{"title":"Citas","openapi":"POST /v2/reports/citations","tag":"Beta","href":"/es/rest-api/reports/query-citations-v2"},{"title":"Visibilidad","openapi":"POST /v2/reports/visibility","tag":"Beta","href":"/es/rest-api/reports/query-visibility-v2"},{"title":"Sentimiento","openapi":"POST /v2/reports/sentiment","tag":"Beta","href":"/es/rest-api/reports/query-sentiment-v2"},{"title":"Consultas fanout","openapi":"POST /v2/reports/query-fanouts","tag":"Beta","href":"/es/rest-api/reports/query-fanouts-v2"},{"group":"FactCheck","tag":"Beta","pages":[{"title":"FactCheck","openapi":"POST /v2/reports/factcheck","tag":"Beta","href":"/es/rest-api/reports/query-factcheck-v2"},{"title":"Afirmaciones de FactCheck","openapi":"POST /v2/reports/factcheck/claims","tag":"Beta","href":"/es/rest-api/reports/query-factcheck-claims-v2"}]},{"group":"Compras","tag":"Beta","pages":[{"title":"Marcas","openapi":"POST /v2/reports/shopping/brands","tag":"Beta","href":"/es/rest-api/reports/query-shopping-brands-v2"},{"title":"Productos","openapi":"POST /v2/reports/shopping/products","tag":"Beta","description":null,"href":"/es/rest-api/reports/query-shopping-products-v2"},{"title":"Comerciantes","openapi":"POST /v2/reports/shopping/merchants","tag":"Beta","href":"/es/rest-api/reports/query-shopping-merchants-v2"},{"title":"Tasa de activación","openapi":"POST /v2/reports/shopping/trigger-rate","tag":"Beta","description":null,"href":"/es/rest-api/reports/query-shopping-trigger-rate-v2"}]},{"group":"YouTube","tag":"Beta","pages":[{"title":"Canales","openapi":"POST /v2/reports/social/youtube/channels","tag":"Beta","href":"/es/rest-api/reports/query-youtube-channels-v2"},{"title":"Videos","openapi":"POST /v2/reports/social/youtube/videos","tag":"Beta","href":"/es/rest-api/reports/query-youtube-videos-v2"}]}]},{"group":"Informes v1","pages":[{"title":"Query Citations","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed post /v1/reports/citations","href":"/api-reference/reports/query-citations"},{"title":"Query Visibility","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed post /v1/reports/visibility","href":"/api-reference/reports/query-visibility"},{"title":"Query Sentiment","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed post /v1/reports/sentiment","href":"/api-reference/reports/query-sentiment"},{"title":"Query Fanouts","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed post /v1/reports/query-fanouts","href":"/api-reference/reports/query-fanouts"}]},{"group":"Tráfico de bots","pages":[{"title":"Get Bots Report V1","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed post /v1/reports/bots","href":"/api-reference/reports/get-bots-report-v1"},{"title":"Get Bots Report V2","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed post /v2/reports/bots","href":"/api-reference/reports/get-bots-report-v2"}]},{"group":"Referencias humanas","pages":[{"title":"Get Referrals Report V1","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed post /v1/reports/referrals","href":"/api-reference/reports/get-referrals-report-v1"},{"title":"Get Referrals Report V2","deprecated":null,"version":null,"openapi":"https://registry.scalar.com/@profound/apis/external-api/latest/openapi.json?variant=processed post /v2/reports/referrals","href":"/api-reference/reports/get-referrals-report-v2"}]}]}]},{"group":"Solicitudes de ejemplo","root":{"title":"Solicitudes de ejemplo","href":"/es/rest-api/examples/example"},"pages":[{"title":"Answer Engine Insights","href":"/es/rest-api/examples/answer-engine-insights"},{"title":"Agent Analytics","href":"/es/rest-api/examples/agent-analytics"},{"title":"Workflows","href":"/es/rest-api/examples/workflows"},{"title":"Knowledge Bases","href":"/es/rest-api/examples/knowledge-bases"},{"title":"Anuncios de OpenAI","tag":"Beta","href":"/es/rest-api/examples/openai-ads"}]},{"group":"API de conversiones","root":{"title":"Primeros pasos con la Conversions API (CAPI)","href":"/es/pixel-conversions-api/introduction"},"tag":"Beta","pages":[{"title":"Enviar un evento de conversión","api":"POST https://capi.profound.click/v1/events","href":"/es/pixel-conversions-api/post-events"}]}]},{"group":"Integraciones","icon":"plug","pages":[{"group":"Tableau","pages":[{"group":"Uso","root":{"title":"Uso","href":"/es/rest-api/integrations/tableau/usage"},"pages":[{"title":"WDC 2.0","tag":"Deprecated","href":"/es/rest-api/integrations/tableau/wdc-2"}]},{"title":"Versiones","href":"/es/rest-api/integrations/tableau/releases"}]}]},{"group":"SDKs","icon":"cube","pages":[{"title":"Primeros pasos con los SDKs","href":"/es/sdks/overview"},{"title":"SDK de Python","href":"/es/sdks/python-package"},{"title":"SDK de JavaScript","href":"/es/sdks/javascript-package"}]}]},{"tab":"Profound MCP","pages":[{"title":"Profound MCP","href":"/es/mcp/overview"}]},{"tab":"Bots","pages":[{"title":"Bots","href":"/es/bots/introduction"}]},{"tab":"Recetario","pages":[{"title":"Recetario","href":"/es/cookbook/introduction"}]}]}]},{"language":"ja-jp","pages":[{"title":"ja-jp","href":"/ja-jp/rest-api/reports/query-shopping-merchants-v2"}]}]},"basePath":"","title":"Comerciantes - Profound","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}