Profound Reports API
The Reports API from Profound — 62 operation(s) for reports.
Profound Reports API is one of 16 APIs that Profound publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Reports. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and a changelog.
This API exposes 62 operations across 62 paths, and defines 196 schemas. It is described by OpenAPI 3.2.0, at version 6551bd49db665ffb7f80780b3e150b8e8b780cc3.
Requests are made against a single base URL, https://api.tryprofound.com.
62 operations
62 paths
196 schemas
62 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 2
Profound Reports API declares
2 security schemes
for authenticating requests.
An API key is passed in the header as X-API-Key (APIKeyHeader).
It accepts HTTP bearer tokens (BearerAuth).
Paths & Operations 62
Across 62 paths, the API surfaces 62 operations — 62 POST. Each is listed below with its method, path, parameters, and response codes.
Reports 62
POST
/v1/reports/citations
Query Citations
POST
/v1/reports/citations/stream
Stream Citations
POST
/v1/reports/visibility
Query Visibility
POST
/v1/reports/visibility/stream
Stream Visibility
POST
/v1/reports/sentiment
Query Sentiment
POST
/v1/reports/sentiment/stream
Stream Sentiment
POST
/v1/reports/sentiment-v2
Query Sentiment V2
POST
/v1/reports/web-search-results
Query Web Search Results
POST
/v1/reports/web-search-results/stream
Stream Web Search Results
POST
/v1/reports/referrals
Get Referrals Report V1
POST
/v1/reports/bots
Get Bots Report V1
POST
/v1/reports/query-fanouts
Query Fanouts
POST
/v1/reports/shopping/visibility
Shopping Visibility
POST
/v1/reports/shopping/item-visibility
Shopping Item Visibility
POST
/v1/reports/shopping/merchant-distribution
Shopping Merchant Distribution
POST
/v1/reports/shopping/merchant-visibility-by-brand
Shopping Merchant Visibility By Brand
POST
/v1/reports/shopping/merchant-by-items
Shopping Merchant By Items
POST
/v1/reports/shopping/all-items-with-merchants
Shopping All Items With Merchants
POST
/v1/reports/shopping/trigger-rate
Shopping Trigger Rate
POST
/v1/reports/shopping/triggered-prompts
Shopping Triggered Prompts
POST
/v1/reports/shopping/triggered-topics
Shopping Triggered Topics
POST
/v1/reports/shopping/merchant-share
Shopping Merchant Share
POST
/v1/reports/shopping/product-merchant-urls
Shopping Product Merchant Urls
POST
/v1/reports/shopping/executions
Shopping Executions
POST
/v1/reports/accuracy/overview
Accuracy Overview
POST
/v1/reports/accuracy/breakdown
Accuracy Breakdown
POST
/v1/reports/accuracy/citation-analysis
Accuracy Citation Analysis
POST
/v1/reports/accuracy/topic-ids
Accuracy Topic Ids
POST
/v1/reports/accuracy/inaccurate-themes
Accuracy Inaccurate Themes
POST
/v1/reports/accuracy/inaccurate-clusters
Accuracy Inaccurate Clusters
POST
/v1/reports/accuracy/inaccuracy-drivers
Accuracy Inaccuracy Drivers
POST
/v1/reports/accuracy/top-inaccurate-claims
Accuracy Top Inaccurate Claims
POST
/v1/reports/accuracy/claim-breakdown
Accuracy Claim Breakdown
POST
/v1/reports/accuracy/claim-citations
Accuracy Claim Citations
POST
/v1/reports/accuracy/cluster-example-runs
Accuracy Cluster Example Runs
POST
/v1/reports/accuracy/cluster-verification-pairs
Accuracy Cluster Verification Pairs
POST
/v1/reports/accuracy/factcheck-setup-status
Accuracy Factcheck Setup Status
POST
/v2/reports/referrals
Get Referrals Report V2
POST
/v2/reports/bots
Get Bots Report V2
POST
/v2/reports/visibility
Query Visibility V2
POST
/v2/reports/visibility/stream
Stream Visibility V2
POST
/v2/reports/citations
Query Citations V2
POST
/v2/reports/citations/stream
Stream Citations V2
POST
/v2/reports/sentiment
Query Sentiment V2
POST
/v2/reports/sentiment/stream
Stream Sentiment V2
POST
/v2/reports/query-fanouts
Query Fanouts V2
POST
/v2/reports/query-fanouts/stream
Stream Query Fanouts V2
POST
/v2/reports/factcheck
Query Scores
POST
/v2/reports/factcheck/stream
Stream Scores
POST
/v2/reports/factcheck/claims
Query Claims
POST
/v2/reports/factcheck/claims/stream
Stream Claims
POST
/v2/reports/social/youtube/channels
Query Youtube Channels
POST
/v2/reports/social/youtube/videos
Query Youtube Videos
POST
/v2/reports/social/youtube/summary
Query Youtube Summary
POST
/v2/reports/shopping/brands
Query Shopping Brands V2
POST
/v2/reports/shopping/brands/stream
Stream Shopping Brands V2
POST
/v2/reports/shopping/products
Query Shopping Products V2
POST
/v2/reports/shopping/products/stream
Stream Shopping Products V2
POST
/v2/reports/shopping/merchants
Query Shopping Merchants V2
POST
/v2/reports/shopping/merchants/stream
Stream Shopping Merchants V2
POST
/v2/reports/shopping/trigger-rate
Query Shopping Trigger Rate V2
POST
/v2/reports/shopping/trigger-rate/stream
Stream Shopping Trigger Rate V2
Schemas 196
The contract defines 196 schemas that model the data the API accepts and returns. The most detailed are AccuracyBreakdownQuery (25 properties), ShoppingItemVisibilityQuery (23 properties), ShoppingVisibilityQuery (22 properties), ShoppingAllItemsWithMerchantsQuery (21 properties). Each schema is shown below with its type and property counts.
SentimentV2ModelIdFilter
object
3 properties
3 required
app__routes__v2__answer_engine_insights__reports__query_fanouts__SortSpec
object
2 properties
1 required
AccuracyThemeTrendPoint
object
4 properties
4 required
AccuracyThemeTrendSeries
object
3 properties
3 required
ShoppingTriggeredPromptsQuery
object
13 properties
3 required
ShoppingProductRow
object
One product row. Merchant fields present only when includemerchants is true.
16 properties
TopicIdFilter
object
Filter by topic UUID.
3 properties
3 required
YoutubeChannelsInfo
object
Channel report metadata, including effective paging and grouping settings.
13 properties
9 required
ReferralsQueryV2
object
12 properties
3 required
AccuracyOverviewQuery
object
18 properties
3 required
DimensionRef
object
An {id, name} reference for a grouped dimension value.
2 properties
CitationsV2Query
object
12 properties
3 required
ShoppingRowsResponse
object
2 properties
2 required
VisibilityV2Info
object
9 properties
5 required
SentimentV2Response
object
2 properties
2 required
ClusterVerificationPairsResponse
object
2 properties
1 required
CitationsV2Info
object
10 properties
7 required
FactcheckScoresInfo
object
8 properties
5 required
ClaimCitationsQuery
object
21 properties
4 required
ShoppingMerchantsV2Info
object
9 properties
6 required
ShoppingTriggerRateQuery
object
15 properties
3 required
ShoppingProductsV2Info
object
9 properties
6 required
CitationsResponse
object
2 properties
2 required
ShoppingMerchantsV2Query
object
10 properties
3 required
WebSearchResultsResult
object
2 properties
2 required
SentimentV2ReportResponse
object
2 properties
1 required
SentimentV2PromptIdFilter
object
3 properties
3 required
ModelIdFilter
object
Filter by AI model/platform UUID.
3 properties
3 required
ThemeFilter
object
Filter by theme
3 properties
3 required
ShoppingMerchantByItemsQuery
object
16 properties
3 required
ShoppingTriggerRateV2Info
object
8 properties
5 required
AccuracyBreakdownQuery
object
25 properties
3 required
FactcheckClaimsInfo
object
9 properties
5 required
YoutubeVideoRow
object
13 properties
5 required
BrandNameFilter
object
3 properties
3 required
FactcheckClaim
object
One inaccurate claim. theme/reasoning/models/evidence/citationsources follow include.
8 properties
FactCheckSetupStatusResponse
object
5 properties
3 required
YoutubeSummaryResponse
object
2 properties
2 required
ShoppingMerchantShareQuery
object
17 properties
3 required
ShoppingMerchantsV2Response
object
2 properties
2 required
SentimentV2TopicIdFilter
object
3 properties
3 required
SentimentV2SentimentFilter
object
3 properties
3 required
SentimentV2ThemeFilter
object
3 properties
3 required
SearchQueryFilter
object
Filter by web-search query string.
3 properties
3 required
TagNameFilter
object
Filter by tag name.
3 properties
3 required
YoutubeVideosInfo
object
Video report metadata, including effective paging and attribution settings.
12 properties
8 required
QueryFanoutsQuery
object
9 properties
4 required
SentimentV2ReportInfo
object
2 properties
2 required
BotProviderFilter
object
Filter by bot provider
3 properties
3 required
ShoppingProductsV2Query
object
13 properties
3 required
ShoppingBrandsV2Response
object
2 properties
2 required
ClaimBreakdownQuery
object
17 properties
4 required
InaccurateClusterRow
object
14 properties
10 required
MerchantNameFilter
object
3 properties
3 required
app__routes__v2__answer_engine_insights__reports__sentiment__SortSpec
object
2 properties
AccuracyOverviewResponse
object
6 properties
3 required
FactcheckClaimsResponse
object
2 properties
2 required
SentimentV2ReportQuery
object
12 properties
5 required
Response
object
Base response model for reports.
2 properties
2 required
SentimentV2ClaimIdFilter
object
3 properties
3 required
AccuracyScoreBreakdown
object
5 properties
3 required
PersonaIdFilter
object
Filter by persona UUID.
3 properties
3 required
TopInaccurateClaimRow
object
4 properties
3 required
ClusterExampleRun
object
6 properties
6 required
FactcheckScoresResponse
object
2 properties
2 required
PromptTypeFilter
object
Filter by prompt type (visibility or sentiment). .. deprecated:: Use :class:AnalysisTypeFilter instead. prompttype is normalised to analysistype at parse time.
3 properties
3 required
SentimentRow
object
One group-combination row. Group dims and metrics present depend on groupby/metrics.
18 properties
ShoppingMerchantDistributionQuery
object
17 properties
3 required
EntityFilterClause
object
Select/exclude the entity, applied outside the data filter tree.
2 properties
2 required
ClaimPromptBreakdownRow
object
12 properties
11 required
ShoppingMerchantVisibilityByBrandQuery
object
19 properties
3 required
YoutubeChannelRow
object
One channel (or video category) row, optionally sliced.
11 properties
5 required
AccuracyTrendPoint
object
6 properties
4 required
SentimentScores
object
6 properties
3 required
AccuracyBreakdownResponse
object
2 properties
2 required
SentimentV2TagIdFilter
object
3 properties
3 required
SentimentQuery
object
9 properties
4 required
CitationsV2Response
object
2 properties
2 required
PromptIdFilter
object
Filter by prompt UUID.
3 properties
3 required
Pagination
object
Offset-based pagination parameters.
2 properties
AccuracyTopicIdsQuery
object
3 properties
3 required
RegionIdFilter
object
Filter by region UUID.
3 properties
3 required
YoutubeChannelsQuery
object
Channel and category rollups.
9 properties
3 required
SentimentMetrics
object
3 properties
ShoppingTriggerRateRow
object
One trigger-rate row. Group dims present depend on groupby.
8 properties
ClaimCitationRow
object
9 properties
8 required
YoutubeSummaryInfo
object
Summary report metadata.
9 properties
6 required
ClusterModelShare
object
2 properties
2 required
InaccuracyDriverRow
object
A top inaccurate claim paired with one of its most-cited pages.
11 properties
10 required
ShoppingBrandRow
object
One (asset x group) row. Group dims/metrics present depend on groupby/metrics.
9 properties
StreamVisibilityQuery
object
9 properties
4 required
FactcheckClaimsQuery
object
The inaccurate claims — flat + paginated, or groupby one dim to section them (all claims per section).
9 properties
3 required
ProductNameFilter
object
3 properties
3 required
StreamCitationsQuery
object
9 properties
4 required
StreamSentimentQuery
object
9 properties
4 required
AssetRef
object
2 properties
HTTPValidationError
object
1 property
BotTypeFilter
object
Filter by bottype column (v2 hourly table only)
3 properties
3 required
InaccurateThemeRow
object
11 properties
9 required
MentionedFilter
object
Filter citation pages by whether they mention an owned category asset.
3 properties
3 required
ClaimCitationSource
object
6 properties
RootDomainFilter
object
Filter by root domain
3 properties
3 required
ReferralSourceFilter
object
Filter by referral source. Values are not enum-constrained so the platform's shared provider filter can pass through IDs that have bot data but no referral dat…
3 properties
3 required
Info
object
Base model for report information.
2 properties
1 required
ShoppingBrandsV2Query
object
12 properties
3 required
TopicNameFilter
object
Filter by topic name
3 properties
3 required
ReferralsQuery
object
11 properties
3 required
ClusterVerificationPairsQuery
object
2 properties
2 required
InaccuracyDriversResponse
object
1 property
1 required
SentimentV2ClaimFilter
object
3 properties
3 required
HostnameFilter
object
Filter by hostname
3 properties
3 required
NumericMetricFilter
object
3 properties
3 required
InaccurateThemesResponse
object
2 properties
2 required
PathFilter
object
Filter by request path
3 properties
3 required
ShoppingProductsV2Response
object
2 properties
2 required
UrlFilter
object
Filter by URL
3 properties
3 required
ShoppingBrandsV2Info
object
10 properties
6 required
YoutubeChannelsResponse
object
2 properties
2 required
ShoppingAllItemsWithMerchantsQuery
object
21 properties
3 required
VisibilityV2Response
object
2 properties
2 required
ShoppingTriggeredTopicsQuery
object
13 properties
3 required
InaccurateClustersResponse
object
2 properties
2 required
VisibilityRow
object
One (asset x group) row. Group dimensions and metrics present depend on groupby/metrics.
11 properties
ClusterExampleRunsQuery
object
19 properties
4 required
InaccurateClustersQuery
object
21 properties
3 required
ClusterExampleRunsResponse
object
2 properties
2 required
YoutubeVideosResponse
object
2 properties
2 required
SentimentV2Query
object
15 properties
4 required
ShoppingTriggerRateV2Response
object
2 properties
2 required
ValidationError
object
5 properties
3 required
QueryFanoutRow
object
One row. Group dimensions are plain values (not {id, name}); metrics present depend on metrics.
10 properties
AccuracyTrendSeriesMeta
object
3 properties
3 required
SentimentV2RunIdFilter
object
3 properties
3 required
VisibilityQuery
object
9 properties
4 required
FactcheckClaimsRow
object
A flat claim, or (with groupby) a section: a dimension + accuracy rollup + its claims. Present fields depend on groupby/include.
19 properties
FactCheckSetupStatusQuery
object
1 property
1 required
StreamWebSearchResultsQuery
object
9 properties
4 required
BotsReportQuery
object
11 properties
3 required
AccuracyCitationEvidence
object
A single knowledge-base ground-truth snippet that refutes a claim's cluster. kbname is the official knowledge base name; kbpath is the document path within tha…
3 properties
QueryFanoutsV2Response
object
2 properties
2 required
FactcheckScoresQuery
object
Accuracy scores. groupby picks the slice (one or two dimensions); empty → the headline score.
8 properties
3 required
SentimentV2ReportDataPoint
object
8 properties
1 required
ShoppingMerchantRow
object
One merchant row. brandname/brandshare appear in the brand-share view; product/product metrics in the top-products view; metrics vary by view.
12 properties
AssetIdFilter
object
3 properties
3 required
InaccurateThemesQuery
object
21 properties
3 required
WebSearchResultsQuery
object
9 properties
4 required
profound_shopping__api__AssetNameFilter
object
3 properties
3 required
WebSearchResultsResponse
object
2 properties
2 required
SentimentPeriodScores
object
2 properties
ShoppingExecutionsQuery
object
16 properties
3 required
CitationsQuery
object
9 properties
4 required
ClaimEvidence
object
4 properties
CitationRow
object
One (source x group) row. Each row carries domain or page; group dims/metrics vary.
12 properties
TopInaccurateClaimsQuery
object
17 properties
3 required
CitationCategoryFilter
object
Filter by citation category
3 properties
3 required
BotNameFilter
object
Filter by bot name (user agent). Values come from analytics data and should not be enum-constrained because web-v2 may send newly cataloged user-agent names.
3 properties
3 required
AccuracyCitationClaim
object
A single inaccurate claim mapped to a cluster, surfaced on a cited page. attribute carries the cluster's canonical claim so the drawer can group claims the sam…
12 properties
7 required
SentimentV2Info
object
11 properties
6 required
YoutubeSummaryQuery
object
One object describing the window.
4 properties
3 required
AccuracyCitationAnalysisResponse
object
5 properties
4 required
FilterNode
object
A leaf (field/op/value) or an and/or/not group.
6 properties
SentimentV2ReportGroupMetadata
object
16 properties
ReferralTypeFilter
object
Filter by referral type
3 properties
3 required
ShoppingItemVisibilityQuery
object
23 properties
3 required
SentimentV2ThemeIdFilter
object
3 properties
3 required
ClaimBreakdownRow
object
8 properties
7 required
VisibilityV2Query
object
13 properties
3 required
BotsReportQueryV2
object
14 properties
3 required
ClaimModelOccurrence
object
3 properties
TagIdFilter
object
Filter by tag (prompt group) UUID.
3 properties
3 required
QueryFanoutsV2Info
object
9 properties
6 required
RegionNameFilter
object
Filter by region name.
3 properties
3 required
TopInaccurateClaimsResponse
object
1 property
1 required
InaccuracyDriversQuery
object
17 properties
3 required
ShoppingTriggerRateV2Query
object
10 properties
3 required
CitationsResult
object
2 properties
2 required
AnalysisTypeFilter
object
Filter by analysis type (visibility, sentiment, or accuracy).
3 properties
3 required
ShoppingProductMerchantUrlsQuery
object
4 properties
4 required
QueryFanoutsV2Query
object
11 properties
3 required
ShoppingVisibilityQuery
object
22 properties
3 required
PromptFilter
object
Filter by prompt text
3 properties
3 required
CitationScoreRef
object
2 properties
AccuracyBreakdownRow
object
14 properties
5 required
Result
object
Base model for report results.
2 properties
2 required
SentimentV2PersonaIdFilter
object
3 properties
3 required
AccuracyPagination
object
Canonical grouped pagination plan for Accuracy Breakdown rows.
4 properties
AccuracyCitationAnalysisQuery
object
4 properties
4 required
YoutubeCoverage
object
How much of youtube.com the rollups can speak for.
11 properties
ClaimCitationsResponse
object
2 properties
2 required
ClaimBreakdownResponse
object
2 properties
2 required
ClusterVerificationPair
object
6 properties
5 required
FactcheckScoreRow
object
An accuracy score row: the headline (no dims), a daily point, or a per-dimension breakdown.
12 properties
YoutubeVideosQuery
object
Cited videos, optionally narrowed to specific channels.
8 properties
3 required
profound_answer_engine_insights__filters__AssetNameFilter
object
Filter by asset name
3 properties
3 required
app__routes__v2__answer_engine_insights__reports__visibility__SortSpec
object
1 property
SentimentV2RegionIdFilter
object
3 properties
3 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Profound 12
Other APIs Profound publishes across the network.
Profound Agent Analytics Ingestion API
Profound Agents API
Profound Beta API
Profound Bot Traffic Reports API
Profound Categories API
Profound Content API
Profound Content optimization API
Profound Documents API
Profound Human Referrals API
Profound Integrations API
Profound Knowledge bases API
Profound OpenAI Ads API
#Reports
Where this information came from
This is an independent, third-party profile of Profound Reports API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.