Profound

Profound Reports API

The Reports API from Profound — 62 operation(s) for reports.

GitHub OpenAPI
Business capability
Market Intelligence Management BC-400.30

Operations 62

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v1/reports/citations Report which sources AI answers cite · Query Citations #
Ask an LLM
“Which websites do AI answers cite most in my category?”
“Can I limit a citations report to pages that mention my brand?”
Tell an agent
Report citation {metrics} for category {category_id} from {start_date} to {end_date}.
Break down cited domains in category {category_id} by {dimensions} between {start_date} and {end_date}, measuring {metrics}.
POST /v1/reports/citations/stream Stream the v1 citations report · Stream Citations #
Ask an LLM
“Can I stream a big citations report row by row rather than paginate it?”
“Does the streaming citations export honor the same filters as the regular report?”
Tell an agent
Stream citation {metrics} rows for category {category_id}, {start_date} to {end_date}.
Open a v1 cited-sources stream for category {category_id} over {start_date}–{end_date} with filters {filters} and metrics {metrics}.
POST /v1/reports/visibility Report brand visibility in AI answers · Query Visibility #
Ask an LLM
“How visible is my brand in AI-generated answers compared with competitors?”
“Can I track my visibility score week over week for a category?”
Tell an agent
Report visibility {metrics} for category {category_id} from {start_date} to {end_date}.
Show brand visibility in category {category_id} by {date_interval} between {start_date} and {end_date}, measuring {metrics}.
POST /v1/reports/visibility/stream Stream the v1 visibility report · Stream Visibility #
Ask an LLM
“Is there a streaming version of the original visibility report?”
“Can I export a long visibility history as a stream?”
Tell an agent
Stream visibility {metrics} for category {category_id}, {start_date} through {end_date}.
Open a v1 brand-presence stream for category {category_id} over {start_date}–{end_date} split by {dimensions} with metrics {metrics}.
POST /v1/reports/sentiment Report sentiment toward brands in AI answers · Query Sentiment #
Ask an LLM
“Do AI answers talk about my brand positively or negatively?”
“Can I see sentiment trends for my category over time?”
Tell an agent
Report sentiment {metrics} for category {category_id} from {start_date} to {end_date}.
Break down v1 tone of AI mentions in category {category_id} by {dimensions}, {start_date} to {end_date}, metrics {metrics}.
POST /v1/reports/sentiment/stream Stream the v1 sentiment report · Stream Sentiment #
Ask an LLM
“Can I stream the original sentiment report rather than wait for one big response?”
“How do I export months of sentiment rows without paging?”
Tell an agent
Stream sentiment {metrics} for category {category_id}, {start_date} through {end_date}.
Open a v1 tone stream for category {category_id} across {start_date}–{end_date} with filters {filters} and metrics {metrics}.
POST /v1/reports/sentiment-v2 Report sentiment for one named brand · Query Sentiment V2 #
Ask an LLM
“What's the sentiment toward one specific brand by name, compared with a prior period?”
“Can I bucket a single brand's sentiment by week on the sentiment-v2 route?”
Tell an agent
Report sentiment {metrics} for brand {asset_name} in category {category_id} from {start_date} to {end_date}.
Compare {asset_name} sentiment {metrics} in {category_id}, {start_date}–{end_date} vs {comparison_start_date}–{comparison_end_date}, by {date_bucket}.
POST /v1/reports/web-search-results Report web search results behind AI answers · Query Web Search Results #
Ask an LLM
“Which web search results do AI engines pull up for my category's prompts?”
“Can I count how often a domain appears in AI web searches?”
Tell an agent
Report web search result {metrics} for category {category_id} from {start_date} to {end_date}.
Show the search-engine results AI fetched in category {category_id} by {dimensions}, {start_date} to {end_date}, metrics {metrics}.
POST /v1/reports/web-search-results/stream Stream the web search results report · Stream Web Search Results #
Ask an LLM
“Can I stream all the web search results behind AI answers?”
“Is there a streaming export of retrieved search results for a long date range?”
Tell an agent
Stream web search result {metrics} for category {category_id}, {start_date} through {end_date}.
Open a stream of retrieved search listings for category {category_id} over {start_date}–{end_date} with filters {filters} and metrics {metrics}.
POST /v1/reports/referrals Report daily human referrals from AI · Get Referrals Report V1 #
Ask an LLM
“How much daily referral traffic are AI assistants sending to my site?”
“Can I get day-level referral numbers across a long period efficiently?”
Tell an agent
Report daily referral {metrics} for {domain} since {start_date}.
Pull day-by-day referral {metrics} for {domain} between {start_date} and {end_date}.
POST /v1/reports/bots Report daily AI bot traffic to a domain · Get Bots Report V1 #
Ask an LLM
“How many AI crawler visits did my site get each day?”
“Can I see daily counts of training versus indexing bot events over a long date range?”
Tell an agent
Report daily bot {metrics} for {domain} since {start_date}.
Pull the day-level crawler {metrics} for {domain} from {start_date} to {end_date}.
POST /v1/reports/query-fanouts Report AI query fan-outs · Query Fanouts #
Ask an LLM
“What follow-up searches do AI engines fan out to when answering my prompts?”
“Can I count the sub-queries generated per prompt in a category?”
Tell an agent
Report query fan-out {metrics} for category {category_id} from {start_date} to {end_date}.
Show the sub-searches AI ran in category {category_id} grouped by {dimensions}, {start_date} to {end_date}, using the v1 fan-out report with metrics {metrics}.
POST /v1/reports/shopping/visibility Report brand visibility in AI shopping results · Shopping Visibility #
Ask an LLM
“How often does my brand show up in AI shopping recommendations?”
“Can I rank brands by shopping visibility against a previous period?”
Tell an agent
Show how often brands appear in AI shopping results for category {category_id} from {start_date} to {end_date}.
Rank brands in AI shopping for category {category_id} by {rank_by}, {start_date} to {end_date}, versus {comparison_start_date}–{comparison_end_date}.
POST /v1/reports/shopping/item-visibility Report product visibility in AI shopping · Shopping Item Visibility #
Ask an LLM
“Which of my products appear in AI shopping carousels, and how often?”
“Can I compare one target product against its competing items?”
Tell an agent
Report item-level shopping visibility for category {category_id} from {start_date} to {end_date}.
Compare product {target_product} with up to {competitor_limit} rival items in category {category_id}, {start_date}–{end_date}.
POST /v1/reports/shopping/merchant-distribution Report which merchants AI shopping shows · Shopping Merchant Distribution #
Ask an LLM
“Which retailers get surfaced most in AI shopping answers for my category?”
“Can I look up how often one merchant appears?”
Tell an agent
Show the merchant distribution for category {category_id} from {start_date} to {end_date}.
Find how retailer {search_merchant} is spread across AI shopping in category {category_id}, {start_date}–{end_date}.
POST /v1/reports/shopping/merchant-visibility-by-brand Report merchant visibility for each brand · Shopping Merchant Visibility By Brand #
Ask an LLM
“Which stores carry my brand when AI recommends products?”
“Can I see merchant visibility for just one brand?”
Tell an agent
Show merchant visibility by brand in category {category_id} from {start_date} to {end_date}.
List which retailers surface brand {search_brand} in category {category_id}, {start_date}–{end_date}.
POST /v1/reports/shopping/merchant-by-items Report merchants offering each product · Shopping Merchant By Items #
Ask an LLM
“Which merchants does AI shopping list for a particular product?”
“Can I break merchants down item by item?”
Tell an agent
Show merchants by item in category {category_id} from {start_date} to {end_date}.
List the sellers shown for product {product_name} in category {category_id}, {start_date}–{end_date}.
POST /v1/reports/shopping/all-items-with-merchants List all shopping items with their merchants · Shopping All Items With Merchants #
Ask an LLM
“Can I get the full catalog of products AI shopping showed, each with its merchants?”
“Is it possible to sort every shopping item by rank?”
Tell an agent
List every shopping item and its merchants for category {category_id} from {start_date} to {end_date}.
Dump all products with sellers in category {category_id}, {start_date}–{end_date}, ranked by {rank_by} in {sort_order} order.
POST /v1/reports/shopping/trigger-rate Report how often prompts trigger shopping · Shopping Trigger Rate #
Ask an LLM
“What percentage of my prompts make AI show shopping results?”
“Has the shopping trigger rate changed versus last month?”
Tell an agent
Report the shopping trigger rate for category {category_id} from {start_date} to {end_date}.
Compare prompts producing product cards in {category_id}, {start_date}–{end_date} vs {comparison_start_date}–{comparison_end_date}.
POST /v1/reports/shopping/triggered-prompts List prompts that triggered shopping results · Shopping Triggered Prompts #
Ask an LLM
“Which exact prompts caused AI to show shopping results?”
“Can I exclude certain topics when listing shopping-triggering prompts?”
Tell an agent
List prompts that triggered shopping in category {category_id} from {start_date} to {end_date}.
Show which questions led to product listings in category {category_id}, {start_date}–{end_date}, excluding topics {exclude_topic_ids}.
POST /v1/reports/shopping/triggered-topics List topics that triggered shopping results · Shopping Triggered Topics #
Ask an LLM
“Which topics are most likely to trigger AI shopping results?”
“Can I include untagged prompts when ranking shopping-triggering topics?”
Tell an agent
List topics that triggered shopping in category {category_id} from {start_date} to {end_date}.
Rank subject areas by shopping activation in category {category_id}, {start_date}–{end_date}, including untagged {include_no_tag}.
POST /v1/reports/shopping/merchant-share Report merchant share for target brands · Shopping Merchant Share #
Ask an LLM
“What share of AI shopping placements does each merchant hold for my brands?”
“Can I calculate merchant share for a specific set of brands?”
Tell an agent
Report merchant share in category {category_id} from {start_date} to {end_date}.
Calculate each retailer's slice of placements for brands {target_asset_names} in category {category_id}, {start_date}–{end_date}.
POST /v1/reports/shopping/product-merchant-urls Get merchant URLs for named products · Shopping Product Merchant Urls #
Ask an LLM
“Which merchant links does AI shopping give for my products?”
“Can I get the store URLs for a list of product names?”
Tell an agent
Get merchant URLs for products {product_names} in category {category_id} from {start_date} to {end_date}.
Show the store links listed for {product_names} in category {category_id}, {start_date}–{end_date}.
POST /v1/reports/shopping/executions List individual shopping prompt executions · Shopping Executions #
Ask an LLM
“Can I see each individual prompt run that produced shopping results?”
“Is it possible to filter shopping executions by analysis type?”
Tell an agent
List shopping executions for category {category_id} from {start_date} to {end_date}.
Show each shopping run in category {category_id}, {start_date}–{end_date}, with analysis types {analysis_types}.
POST /v1/reports/accuracy/overview Get an overview of AI answer accuracy · Accuracy Overview #
Ask an LLM
“How accurately do AI answers describe my brand overall?”
“Has answer accuracy improved compared with the previous period?”
Tell an agent
Give me the accuracy overview for category {category_id} from {start_date} to {end_date}.
Summarize answer correctness in category {category_id}, {start_date}–{end_date}, bucketed by {date_bucket}, grouped by {group_by}.
POST /v1/reports/accuracy/breakdown Break down AI answer accuracy by dimension · Accuracy Breakdown #
Ask an LLM
“Which platforms or topics have the least accurate answers about us?”
“Can I split accuracy by region or persona and sort the results?”
Tell an agent
Break down accuracy by {breakdown_by} for category {category_id} from {start_date} to {end_date}.
Split correctness rates in category {category_id}, {start_date}–{end_date}, by {breakdown_by} sorted on {sort_by}.
POST /v1/reports/accuracy/citation-analysis Analyze accuracy for one cited URL · Accuracy Citation Analysis #
Ask an LLM
“Is a specific cited page leading AI to say inaccurate things about us?”
“Can I check accuracy for answers that cite one particular URL?”
Tell an agent
Analyze accuracy for cited URL {clean_href} in category {category_id} from {start_date} to {end_date}.
Check whether page {clean_href} drives wrong answers in category {category_id}, {start_date}–{end_date}.
POST /v1/reports/accuracy/topic-ids List topics with accuracy data · Accuracy Topic Ids #
Ask an LLM
“Which topics have fact-check accuracy data in a date range?”
“Where can I get the topic IDs to filter accuracy reports by?”
Tell an agent
List the topic IDs with accuracy data in category {category_id} from {start_date} to {end_date}.
Which topics were fact-checked in category {category_id} between {start_date} and {end_date}? Get their IDs.
POST /v1/reports/accuracy/inaccurate-themes List recurring themes of inaccurate answers · Accuracy Inaccurate Themes #
Ask an LLM
“What recurring themes show up in AI's wrong answers about my brand?”
“Can I search inaccurate themes by keyword?”
Tell an agent
List inaccurate themes for category {category_id} from {start_date} to {end_date}.
Find misinformation themes matching {search_query} in category {category_id}, {start_date}–{end_date}.
POST /v1/reports/accuracy/inaccurate-clusters List clusters of similar inaccurate claims · Accuracy Inaccurate Clusters #
Ask an LLM
“How are similar wrong claims about us grouped into clusters?”
“Can I see the inaccurate claim clusters under one theme, with the models involved?”
Tell an agent
List inaccurate claim clusters for category {category_id} from {start_date} to {end_date}.
Show the error clusters within theme {theme_id} in category {category_id}, {start_date}–{end_date}, including models {include_models}.
POST /v1/reports/accuracy/inaccuracy-drivers Find what drives inaccurate AI answers · Accuracy Inaccuracy Drivers #
Ask an LLM
“What's driving AI to give inaccurate answers about my company?”
“Can I narrow the inaccuracy drivers to certain platforms?”
Tell an agent
Show the inaccuracy drivers for category {category_id} from {start_date} to {end_date}.
Identify the top {limit} causes of wrong answers on platforms {platform_ids} in category {category_id}, {start_date}–{end_date}.
POST /v1/reports/accuracy/top-inaccurate-claims List the most common inaccurate claims · Accuracy Top Inaccurate Claims #
Ask an LLM
“What are the most frequent false statements AI makes about us?”
“Can I get just the top few inaccurate claims for one persona?”
Tell an agent
List the top inaccurate claims for category {category_id} from {start_date} to {end_date}.
Give me the {limit} most repeated false statements for personas {persona_ids} in category {category_id}, {start_date}–{end_date}.
POST /v1/reports/accuracy/claim-breakdown Break down one inaccurate claim cluster · Accuracy Claim Breakdown #
Ask an LLM
“Can I drill into a single cluster of inaccurate claims to see its breakdown?”
“Where does one specific false claim cluster appear most?”
Tell an agent
Break down claim cluster {cluster_id} in category {category_id} from {start_date} to {end_date}.
Drill into wrong-claim group {cluster_id} for category {category_id}, {start_date}–{end_date}.
POST /v1/reports/accuracy/claim-citations List sources cited by an inaccurate claim cluster · Accuracy Claim Citations #
Ask an LLM
“Which sources are cited alongside a cluster of inaccurate claims?”
“Can I search the citations behind one false claim group?”
Tell an agent
List citations for claim cluster {cluster_id} in category {category_id} from {start_date} to {end_date}.
Find sources matching {search_query} behind wrong-claim group {cluster_id}, category {category_id}, {start_date}–{end_date}.
POST /v1/reports/accuracy/cluster-example-runs Show example answers for a claim cluster · Accuracy Cluster Example Runs #
Ask an LLM
“Can I see real AI answers that contained a particular inaccurate claim?”
“How do I page through example runs for one claim cluster?”
Tell an agent
Show example runs for claim cluster {cluster_id} in category {category_id} from {start_date} to {end_date}.
Pull {limit} sample responses containing error group {cluster_id}, category {category_id}, {start_date}–{end_date}.
POST /v1/reports/accuracy/cluster-verification-pairs Get verification pairs for a claim cluster · Accuracy Cluster Verification Pairs #
Ask an LLM
“How was a cluster of claims verified against the facts?”
“Can I see the claim-versus-evidence pairs behind one inaccurate cluster?”
Tell an agent
Get verification pairs for claim cluster {cluster_id} in category {category_id}.
Show the claim and evidence pairings used to verify group {cluster_id} in category {category_id}.
POST /v1/reports/accuracy/factcheck-setup-status Check fact-check setup status for a category · Accuracy Factcheck Setup Status #
Ask an LLM
“Is fact-checking set up for my category yet?”
“Why might accuracy reports be empty for a category?”
Tell an agent
Check the fact-check setup status for category {category_id}.
Is accuracy tracking configured for category {category_id}? Confirm it.
POST /v2/reports/referrals Report hourly human referrals from AI · Get Referrals Report V2 #
Ask an LLM
“Which hours of the day bring the most AI-referred visitors to my site?”
“Is there a referral report that supports hourly, quarterly or relative-week intervals?”
Tell an agent
Show hourly referral {metrics} for {domain} from {start_date}.
Get v2 referral {metrics} for {domain} at {date_interval} intervals in timezone {timezone} from {start_date}.
POST /v2/reports/bots Report hourly AI bot traffic to a domain · Get Bots Report V2 #
Ask an LLM
“Which AI bots hit my site hour by hour, and on which paths?”
“Can I break bot visits down by bot provider and bot type in my own timezone?”
Tell an agent
Show hourly bot {metrics} for {domain} starting {start_date}, grouped by {dimensions}.
Get v2 bot {metrics} for {domain} from {start_date} at {date_interval} granularity in timezone {timezone}.
POST /v2/reports/visibility Query brand visibility (v2, cursor-paged) · Query Visibility V2 #
Ask an LLM
“Is there a newer visibility report that lets me pick which brands to compare?”
“Can I page through v2 visibility results with a cursor?”
Tell an agent
Query v2 visibility for category {category_id} from {start_date} to {end_date} for assets {assets}.
Group v2 brand presence in category {category_id} by {group_by} at {interval} intervals, {start_date}–{end_date}, from cursor {cursor}.
POST /v2/reports/visibility/stream Stream brand visibility (v2) · Stream Visibility V2 #
Ask an LLM
“Can I stream the v2 visibility data instead of paging with a cursor?”
“How do I export all v2 visibility rows for a brand set in one stream?”
Tell an agent
Stream v2 visibility for category {category_id} from {start_date} through {end_date}.
Open a v2 presence stream for assets {assets} in category {category_id}, {start_date}–{end_date}, scope {scope}.
POST /v2/reports/citations Query cited sources (v2, cursor-paged) · Query Citations V2 #
Ask an LLM
“Can the newer citations report rank cited domains or pages as different entities?”
“How do I page through v2 citation results?”
Tell an agent
Query v2 citations for category {category_id} from {start_date} to {end_date} by entity {entity}.
Group v2 cited sources in category {category_id} by {group_by}, {start_date}–{end_date}, {limit} rows from cursor {cursor}.
POST /v2/reports/citations/stream Stream cited sources (v2) · Stream Citations V2 #
Ask an LLM
“Is there a streaming version of the v2 citations report?”
“Can I stream every v2 citation row for a long date range?”
Tell an agent
Stream v2 citations for category {category_id} from {start_date} through {end_date}.
Open a v2 referenced-sources stream for category {category_id}, {start_date}–{end_date}, entity {entity}, at {interval} intervals.
POST /v2/reports/sentiment Query brand sentiment (v2, cursor-paged) · Query Sentiment V2 #
Ask an LLM
“Can the v2 sentiment report show which websites were cited in positive or negative answers?”
“How do I compare a brand's v2 sentiment against an earlier window?”
Tell an agent
Query v2 sentiment for asset {asset} in category {category_id} from {start_date} to {end_date}.
Compare v2 tone for {asset} in {category_id}, {start_date}–{end_date} vs {comparison_start_date}–{comparison_end_date}, cited sites {include_cited_websites}.
POST /v2/reports/sentiment/stream Stream brand sentiment (v2) · Stream Sentiment V2 #
Ask an LLM
“Can I stream v2 sentiment rows for a brand rather than page them?”
“Is there a streaming export of the newer per-asset sentiment report?”
Tell an agent
Stream v2 sentiment for asset {asset} in category {category_id} from {start_date} through {end_date}.
Open a v2 tone stream for brand {asset}, category {category_id}, {start_date}–{end_date}, grouped by {group_by}.
POST /v2/reports/query-fanouts Query AI query fan-outs (v2, cursor-paged) · Query Fanouts V2 #
Ask an LLM
“Is there a newer fan-out report I can page with a cursor?”
“Can I sort the v2 sub-query results by a metric?”
Tell an agent
Query v2 fan-outs for category {category_id} from {start_date} to {end_date}.
Group v2 follow-up searches in category {category_id} by {group_by}, sorted by {sort}, {start_date}–{end_date}, from cursor {cursor}.
POST /v2/reports/query-fanouts/stream Stream AI query fan-outs (v2) · Stream Query Fanouts V2 #
Ask an LLM
“Can I stream every fan-out sub-query for a category?”
“Is there a streaming export for the v2 fan-out data?”
Tell an agent
Stream v2 fan-outs for category {category_id} from {start_date} through {end_date}.
Open a stream of AI sub-searches in category {category_id}, {start_date}–{end_date}, filtered by {filter}.
POST /v2/reports/factcheck Query fact-check accuracy scores · Query Scores #
Ask an LLM
“What fact-check scores did AI answers get for my category?”
“Can I group fact-check scores by platform or topic?”
Tell an agent
Query fact-check scores for category {category_id} from {start_date} to {end_date}.
Group factcheck scoring in category {category_id} by {group_by}, {start_date}–{end_date}, {limit} per page.
POST /v2/reports/factcheck/stream Stream fact-check accuracy scores · Stream Scores #
Ask an LLM
“Can I stream fact-check scores rather than paging through them?”
“Is there a streaming export of factcheck scoring for a long period?”
Tell an agent
Stream fact-check scores for category {category_id} from {start_date} through {end_date}.
Open a factcheck scoring stream for category {category_id}, {start_date}–{end_date}, filtered by {filter}.
POST /v2/reports/factcheck/claims Query fact-checked claims · Query Claims #
Ask an LLM
“Which individual claims in AI answers were fact-checked, and what was the verdict?”
“Can I page through fact-checked claims for one topic?”
Tell an agent
Query fact-checked claims for category {category_id} from {start_date} to {end_date}.
List verified statements in category {category_id}, {start_date}–{end_date}, filtered by {filter}, from cursor {cursor}.
POST /v2/reports/factcheck/claims/stream Stream fact-checked claims · Stream Claims #
Ask an LLM
“Can I stream all the fact-checked claims for my category?”
“Is there a streaming export of claim-level fact-check verdicts?”
Tell an agent
Stream fact-checked claims for category {category_id} from {start_date} through {end_date}.
Open a stream of claim verdicts in category {category_id}, {start_date}–{end_date}, including {include}.
POST /v2/reports/social/youtube/channels Rank YouTube channels cited by AI · Query Youtube Channels #
Ask an LLM
“Which YouTube channels get cited in AI answers for my category?”
“Can I rank the video categories those cited channels publish in?”
Tell an agent
Rank cited YouTube channels for category {category_id} from {start_date} to {end_date}.
Group cited YouTube creators in category {category_id} by {group_by} at {interval} intervals, {start_date}–{end_date}.
POST /v2/reports/social/youtube/videos Rank YouTube videos cited by AI · Query Youtube Videos #
Ask an LLM
“Which specific YouTube videos do AI answers cite in my category?”
“Can I rank cited videos for just one channel?”
Tell an agent
Rank cited YouTube videos for category {category_id} from {start_date} to {end_date}.
List the top {limit} referenced YouTube clips in category {category_id}, {start_date}–{end_date}, filtered by {filter}.
POST /v2/reports/social/youtube/summary Summarize YouTube's share of AI citations · Query Youtube Summary #
Ask an LLM
“How much of the YouTube citations in my category do the channel and video rankings cover?”
“What share of youtube.com citations are attributed?”
Tell an agent
Summarize YouTube citation coverage for category {category_id} from {start_date} to {end_date}.
Report how much of youtube.com the rankings account for in category {category_id}, {start_date}–{end_date}.
POST /v2/reports/shopping/brands Query brands in AI shopping (v2) · Query Shopping Brands V2 #
Ask an LLM
“Which brands lead AI shopping results in the newer v2 report?”
“Can I page v2 shopping brand results for selected assets?”
Tell an agent
Query v2 shopping brands for category {category_id} from {start_date} to {end_date}.
Group v2 shopping brand placements for assets {assets} in category {category_id} by {group_by}, {start_date}–{end_date}.
POST /v2/reports/shopping/brands/stream Stream brands in AI shopping (v2) · Stream Shopping Brands V2 #
Ask an LLM
“Can I stream the v2 shopping brand data?”
“Is there a streaming export of brand placements in AI shopping?”
Tell an agent
Stream v2 shopping brands for category {category_id} from {start_date} through {end_date}.
Open a brand-placement stream for AI shopping in category {category_id}, {start_date}–{end_date}, scope {scope}.
POST /v2/reports/shopping/products Query products in AI shopping (v2) · Query Shopping Products V2 #
Ask an LLM
“Which products does AI shopping recommend in the v2 product report?”
“Can I benchmark one product against competitors and include merchants?”
Tell an agent
Query v2 shopping products for category {category_id} from {start_date} to {end_date}.
Benchmark product {target_product} against {competitor_limit} competitors in v2 shopping for category {category_id}, {start_date}–{end_date}.
POST /v2/reports/shopping/products/stream Stream products in AI shopping (v2) · Stream Shopping Products V2 #
Ask an LLM
“Can I stream v2 shopping product rows?”
“Is there a streaming export of recommended products with their merchants?”
Tell an agent
Stream v2 shopping products for category {category_id} from {start_date} through {end_date}.
Open an item stream for AI shopping in category {category_id}, {start_date}–{end_date}, with merchants {include_merchants}.
POST /v2/reports/shopping/merchants Query merchants in AI shopping (v2) · Query Shopping Merchants V2 #
Ask an LLM
“Which merchants appear most in the v2 shopping merchant report?”
“Can I group v2 merchant results over time intervals?”
Tell an agent
Query v2 shopping merchants for category {category_id} from {start_date} to {end_date}.
Group v2 retailer appearances in category {category_id} by {group_by} at {interval}, {start_date}–{end_date}.
POST /v2/reports/shopping/merchants/stream Stream merchants in AI shopping (v2) · Stream Shopping Merchants V2 #
Ask an LLM
“Can I stream v2 shopping merchant data?”
“Is there a streaming export of the retailers AI shopping surfaces?”
Tell an agent
Stream v2 shopping merchants for category {category_id} from {start_date} through {end_date}.
Open a retailer stream for AI shopping in category {category_id}, {start_date}–{end_date}, filtered by {filter}.
POST /v2/reports/shopping/trigger-rate Query shopping trigger rate (v2) · Query Shopping Trigger Rate V2 #
Ask an LLM
“What's the v2 shopping trigger rate for my category?”
“Can I group the v2 trigger rate by platform or topic?”
Tell an agent
Query the v2 shopping trigger rate for category {category_id} from {start_date} to {end_date}.
Group v2 shopping activation rates in category {category_id} by {group_by}, {start_date}–{end_date}, at {interval}.
POST /v2/reports/shopping/trigger-rate/stream Stream shopping trigger rate (v2) · Stream Shopping Trigger Rate V2 #
Ask an LLM
“Can I stream the v2 shopping trigger rate?”
“Is there a streaming export of how often prompts trigger product results?”
Tell an agent
Stream the v2 shopping trigger rate for category {category_id} from {start_date} through {end_date}.
Open an activation-rate stream for AI shopping in category {category_id}, {start_date}–{end_date}, filtered by {filter}.

Documentation

📖
Documentation
https://docs.tryprofound.com/rest-api/introduction
📖
APIReference
https://docs.tryprofound.com/api-reference/organization/get-categories
📖
Authentication
https://docs.tryprofound.com/rest-api/authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/profound/refs/heads/main/openapi/profound-reports-api-openapi.yml

Other Resources

🔗
OpenAPI Source
https://api.tryprofound.com/openapi.json
🔗
ChangeLog
https://docs.tryprofound.com/rest-api/changelog

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/profound:profound-reports-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

profound-reports-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: External Reports API
  version: 6551bd49db665ffb7f80780b3e150b8e8b780cc3
servers:
- url: https://api.tryprofound.com
  description: Production Server
tags:


# --- 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