Profound Reports API
The Reports API from Profound — 62 operation(s) for reports.
The Reports API from Profound — 62 operation(s) for reports.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/profound-reports-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
openapi: 3.2.0
info:
title: External Reports API
version: 6551bd49db665ffb7f80780b3e150b8e8b780cc3
servers:
- url: https://api.tryprofound.com
description: Production Server
tags:
- name: Reports
paths:
/v1/reports/citations:
post:
tags:
- Reports
summary: Query Citations
description: 'Get citations for a given category.
The ``mentioned`` filter supports ``is true`` and ``is false``. It uses the
latest page analysis available at or before ``end_date``; pages without an
analysis by then are excluded from both values. ``citation_share`` keeps all
otherwise eligible citations in its denominator when this filter is used.'
operationId: query_citations_v1_reports_citations_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CitationsQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CitationsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/citations/stream:
post:
tags:
- Reports
summary: Stream Citations
description: Stream citations with the same filter semantics as the non-streaming route.
operationId: stream_citations_v1_reports_citations_stream_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/StreamCitationsQuery'
required: true
responses:
'200':
description: Server-sent events stream. Emits a `summary` event first, then one `row` event per streamed row.
content:
text/event-stream:
schema:
oneOf:
- properties:
query:
additionalProperties: true
type: object
title: Query
description: The normalized query used to build the stream.
total_rows:
type: integer
title: Total Rows
description: Total number of rows available before pagination is applied.
type: object
required:
- query
- total_rows
title: SSESummaryEventData
- additionalProperties: true
type: object
description: A streamed citations report row payload.
examples:
summary:
summary: Initial summary event payload
value:
query:
category_id: 12345678-1234-5678-1234-567812345678
metrics:
- count
dimensions:
- model
total_rows: 2
row:
summary: Streamed row event payload
value:
model:
id: 11111111-1111-1111-1111-111111111111
name: GPT-4
count: 42
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/visibility:
post:
tags:
- Reports
summary: Query Visibility
description: Query visibility report.
operationId: query_visibility_v1_reports_visibility_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/VisibilityQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/visibility/stream:
post:
tags:
- Reports
summary: Stream Visibility
operationId: stream_visibility_v1_reports_visibility_stream_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/StreamVisibilityQuery'
required: true
responses:
'200':
description: Server-sent events stream. Emits a `summary` event first, then one `row` event per streamed row.
content:
text/event-stream:
schema:
oneOf:
- properties:
query:
additionalProperties: true
type: object
title: Query
description: The normalized query used to build the stream.
total_rows:
type: integer
title: Total Rows
description: Total number of rows available before pagination is applied.
type: object
required:
- query
- total_rows
title: SSESummaryEventData
- additionalProperties: true
type: object
description: A streamed visibility report row payload.
examples:
summary:
summary: Initial summary event payload
value:
query:
category_id: 12345678-1234-5678-1234-567812345678
metrics:
- count
dimensions:
- model
total_rows: 2
row:
summary: Streamed row event payload
value:
asset:
id: 11111111-1111-1111-1111-111111111111
name: Brand A
mentions_count: 7
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/sentiment:
post:
tags:
- Reports
summary: Query Sentiment
description: Get citations for a given category.
operationId: query_sentiment_v1_reports_sentiment_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SentimentQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/sentiment/stream:
post:
tags:
- Reports
summary: Stream Sentiment
operationId: stream_sentiment_v1_reports_sentiment_stream_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/StreamSentimentQuery'
required: true
responses:
'200':
description: Server-sent events stream. Emits a `summary` event first, then one `row` event per streamed row.
content:
text/event-stream:
schema:
oneOf:
- properties:
query:
additionalProperties: true
type: object
title: Query
description: The normalized query used to build the stream.
total_rows:
type: integer
title: Total Rows
description: Total number of rows available before pagination is applied.
type: object
required:
- query
- total_rows
title: SSESummaryEventData
- additionalProperties: true
type: object
description: A streamed sentiment report row payload.
examples:
summary:
summary: Initial summary event payload
value:
query:
category_id: 12345678-1234-5678-1234-567812345678
metrics:
- count
dimensions:
- model
total_rows: 2
row:
summary: Streamed row event payload
value:
theme: price
occurrences: 12
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/sentiment-v2:
post:
tags:
- Reports
summary: Query Sentiment V2
operationId: query_sentiment_v2_v1_reports_sentiment_v2_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SentimentV2ReportQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SentimentV2ReportResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/web-search-results:
post:
tags:
- Reports
summary: Query Web Search Results
description: Get web search results for a given category.
operationId: query_web_search_results_v1_reports_web_search_results_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/WebSearchResultsQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/WebSearchResultsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/web-search-results/stream:
post:
tags:
- Reports
summary: Stream Web Search Results
operationId: stream_web_search_results_v1_reports_web_search_results_stream_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/StreamWebSearchResultsQuery'
required: true
responses:
'200':
description: Server-sent events stream. Emits a `summary` event first, then one `row` event per streamed row.
content:
text/event-stream:
schema:
oneOf:
- properties:
query:
additionalProperties: true
type: object
title: Query
description: The normalized query used to build the stream.
total_rows:
type: integer
title: Total Rows
description: Total number of rows available before pagination is applied.
type: object
required:
- query
- total_rows
title: SSESummaryEventData
- additionalProperties: true
type: object
description: A streamed web-search-results report row payload.
examples:
summary:
summary: Initial summary event payload
value:
query:
category_id: 12345678-1234-5678-1234-567812345678
metrics:
- count
dimensions:
- model
total_rows: 2
row:
summary: Streamed row event payload
value:
model:
id: 11111111-1111-1111-1111-111111111111
name: GPT-4
count: 42
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/referrals:
post:
tags:
- Reports
summary: Get Referrals Report V1
description: 'Get referral traffic report from the daily aggregated materialized view.
This endpoint queries pre-aggregated daily referral data, making it efficient
for large date ranges and high-traffic sites.'
operationId: get_referrals_report_v1_v1_reports_referrals_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ReferralsQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/bots:
post:
tags:
- Reports
summary: Get Bots Report V1
description: 'Get bot traffic report from the daily aggregated materialized view.
This endpoint queries pre-aggregated daily bot data, making it efficient
for large date ranges and high-traffic sites.
Metrics:
- count: unique bot visits
- citations: unique citation events
- indexing: unique indexing events
- training: unique training events
- last_visit: most recent visit timestamp'
operationId: get_bots_report_v1_v1_reports_bots_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BotsReportQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/query-fanouts:
post:
tags:
- Reports
summary: Query Fanouts
operationId: query_fanouts_v1_reports_query_fanouts_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/QueryFanoutsQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/shopping/visibility:
post:
tags:
- Reports
summary: Shopping Visibility
operationId: shopping_visibility_v1_reports_shopping_visibility_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingVisibilityQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingRowsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/shopping/item-visibility:
post:
tags:
- Reports
summary: Shopping Item Visibility
operationId: shopping_item_visibility_v1_reports_shopping_item_visibility_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingItemVisibilityQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingRowsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/shopping/merchant-distribution:
post:
tags:
- Reports
summary: Shopping Merchant Distribution
operationId: shopping_merchant_distribution_v1_reports_shopping_merchant_distribution_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingMerchantDistributionQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingRowsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/shopping/merchant-visibility-by-brand:
post:
tags:
- Reports
summary: Shopping Merchant Visibility By Brand
operationId: shopping_merchant_visibility_by_brand_v1_reports_shopping_merchant_visibility_by_brand_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingMerchantVisibilityByBrandQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingRowsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/shopping/merchant-by-items:
post:
tags:
- Reports
summary: Shopping Merchant By Items
operationId: shopping_merchant_by_items_v1_reports_shopping_merchant_by_items_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingMerchantByItemsQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingRowsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/shopping/all-items-with-merchants:
post:
tags:
- Reports
summary: Shopping All Items With Merchants
operationId: shopping_all_items_with_merchants_v1_reports_shopping_all_items_with_merchants_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingAllItemsWithMerchantsQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingRowsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/shopping/trigger-rate:
post:
tags:
- Reports
summary: Shopping Trigger Rate
operationId: shopping_trigger_rate_v1_reports_shopping_trigger_rate_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingTriggerRateQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingRowsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/shopping/triggered-prompts:
post:
tags:
- Reports
summary: Shopping Triggered Prompts
operationId: shopping_triggered_prompts_v1_reports_shopping_triggered_prompts_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingTriggeredPromptsQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingRowsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/shopping/triggered-topics:
post:
tags:
- Reports
summary: Shopping Triggered Topics
operationId: shopping_triggered_topics_v1_reports_shopping_triggered_topics_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingTriggeredTopicsQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingRowsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/shopping/merchant-share:
post:
tags:
- Reports
summary: Shopping Merchant Share
operationId: shopping_merchant_share_v1_reports_shopping_merchant_share_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingMerchantShareQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingRowsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/shopping/product-merchant-urls:
post:
tags:
- Reports
summary: Shopping Product Merchant Urls
operationId: shopping_product_merchant_urls_v1_reports_shopping_product_merchant_urls_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingProductMerchantUrlsQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingRowsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/shopping/executions:
post:
tags:
- Reports
summary: Shopping Executions
operationId: shopping_executions_v1_reports_shopping_executions_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingExecutionsQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ShoppingRowsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/accuracy/overview:
post:
tags:
- Reports
summary: Accuracy Overview
operationId: accuracy_overview_v1_reports_accuracy_overview_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AccuracyOverviewQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/AccuracyOverviewResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/accuracy/breakdown:
post:
tags:
- Reports
summary: Accuracy Breakdown
operationId: accuracy_breakdown_v1_reports_accuracy_breakdown_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AccuracyBreakdownQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/AccuracyBreakdownResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/accuracy/citation-analysis:
post:
tags:
- Reports
summary: Accuracy Citation Analysis
operationId: accuracy_citation_analysis_v1_reports_accuracy_citation_analysis_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AccuracyCitationAnalysisQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/AccuracyCitationAnalysisResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/accuracy/topic-ids:
post:
tags:
- Reports
summary: Accuracy Topic Ids
operationId: accuracy_topic_ids_v1_reports_accuracy_topic_ids_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AccuracyTopicIdsQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
type: string
type: array
title: Response Accuracy Topic Ids V1 Reports Accuracy Topic Ids Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/accuracy/inaccurate-themes:
post:
tags:
- Reports
summary: Accuracy Inaccurate Themes
operationId: accuracy_inaccurate_themes_v1_reports_accuracy_inaccurate_themes_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/InaccurateThemesQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/InaccurateThemesResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/accuracy/inaccurate-clusters:
post:
tags:
- Reports
summary: Accuracy Inaccurate Clusters
operationId: accuracy_inaccurate_clusters_v1_reports_accuracy_inaccurate_clusters_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/InaccurateClustersQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/InaccurateClustersResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
/v1/reports/accuracy/inaccuracy-drivers:
post:
tags:
- Reports
summary: Accuracy Inaccuracy Drivers
operationId: accuracy_inaccuracy_drivers_v1_reports_accuracy_inaccuracy_drivers_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/InaccuracyDriversQuery'
required: true
responses:
# --- truncated at 32 KB (357 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/profound/refs/heads/main/openapi/profound-reports-api-openapi.yml