api.md

Shared Types

from profound.types import (
    AnalysisTypeFilter,
    AssetIDFilter,
    BotNameFilter,
    BotProviderFilter,
    CursorPagination,
    ModelIDFilter,
    Pagination,
    PathFilter,
    PersonaIDFilter,
    PromptFilter,
    PromptTypeFilter,
    RegionIDFilter,
    RegionNameFilter,
    TagIDFilter,
    TopicIDFilter,
)

Organizations

Types:

from profound.types import (
    Category,
    NamedResource,
    Organization,
    PersonaProfile,
    PersonaProfileBehavior,
    PersonaProfileDemographics,
    PersonaProfileEmployment,
    OrganizationListResponse,
    OrganizationDomainsResponse,
    OrganizationGetPersonasResponse,
    OrganizationListAssetsResponse,
    OrganizationModelsResponse,
    OrganizationRegionsResponse,
)

Methods:

• client.organizations.list() -> OrganizationListResponse
• client.organizations.domains(**params) -> OrganizationDomainsResponse
• client.organizations.get_personas(**params) -> OrganizationGetPersonasResponse
• client.organizations.list_assets(**params) -> OrganizationListAssetsResponse
• client.organizations.models() -> OrganizationModelsResponse
• client.organizations.regions(**params) -> OrganizationRegionsResponse

Categories

Types:

from profound.types.organizations import (
    FieldDiff,
    IDOrName,
    NamedResourceDiffList,
    CategoryListResponse,
    CategoryAssetsResponse,
    CategoryCreatePromptsResponse,
    CategoryGetCategoryPersonasResponse,
    CategoryGetCitationCategoriesResponse,
    CategoryPromptsResponse,
    CategoryRetrieveRegionsResponse,
    CategoryTagsResponse,
    CategoryTopicsResponse,
    CategoryUpdatePromptStatusResponse,
    CategoryUpdatePromptsResponse,
)

Methods:

• client.organizations.categories.list(**params) -> CategoryListResponse
• client.organizations.categories.assets(category_id) -> CategoryAssetsResponse
• client.organizations.categories.create_prompts(category_id, **params) -> CategoryCreatePromptsResponse
• client.organizations.categories.get_category_personas(category_id) -> CategoryGetCategoryPersonasResponse
• client.organizations.categories.get_citation_categories(category_id) -> CategoryGetCitationCategoriesResponse
• client.organizations.categories.prompts(category_id, **params) -> CategoryPromptsResponse
• client.organizations.categories.retrieve_regions(category_id) -> CategoryRetrieveRegionsResponse
• client.organizations.categories.tags(category_id) -> CategoryTagsResponse
• client.organizations.categories.topics(category_id) -> CategoryTopicsResponse
• client.organizations.categories.update_prompt_status(category_id, **params) -> CategoryUpdatePromptStatusResponse
• client.organizations.categories.update_prompts(category_id, **params) -> CategoryUpdatePromptsResponse

Prompts

Types:

from profound.types import (
    PromptAnswersResponse,
    PromptAnswersV2Response,
    PromptStreamAnswersV2Response,
)

Methods:

• client.prompts.answers(**params) -> PromptAnswersResponse
• client.prompts.answers_v2(**params) -> PromptAnswersV2Response
• client.prompts.stream_answers_v2(**params) -> PromptStreamAnswersV2Response

Reports

Types:

from profound.types import (
    HostnameFilter,
    PromptIDFilter,
    ReportInfo,
    ReportResponse,
    ReportResult,
    RootDomainFilter,
    TagNameFilter,
    TopicNameFilter,
    URLFilter,
    ReportCitationsResponse,
    ReportQueryCitationsResponse,
    ReportQueryQueryFanoutsResponse,
    ReportQuerySentimentResponse,
    ReportQueryVisibilityResponse,
    ReportSentimentV2Response,
    ReportStreamCitationsResponse,
    ReportStreamCitationsV2Response,
    ReportStreamQueryFanoutsResponse,
    ReportStreamSentimentResponse,
    ReportStreamSentimentV2Response,
    ReportStreamVisibilityResponse,
    ReportStreamVisibilityV2Response,
)

Methods:

• client.reports.citations(**params) -> ReportCitationsResponse
• client.reports.get_bots_report(**params) -> ReportResponse
• client.reports.get_bots_report_v2(**params) -> ReportResponse
• client.reports.get_referrals_report(**params) -> ReportResponse
• client.reports.get_referrals_report_v2(**params) -> ReportResponse
• client.reports.query_citations(**params) -> ReportQueryCitationsResponse
• client.reports.query_fanouts(**params) -> ReportResponse
• client.reports.query_query_fanouts(**params) -> ReportQueryQueryFanoutsResponse
• client.reports.query_sentiment(**params) -> ReportQuerySentimentResponse
• client.reports.query_visibility(**params) -> ReportQueryVisibilityResponse
• client.reports.sentiment(**params) -> ReportResponse
• client.reports.sentiment_v2(**params) -> ReportSentimentV2Response
• client.reports.stream_citations(**params) -> ReportStreamCitationsResponse
• client.reports.stream_citations_v2(**params) -> ReportStreamCitationsV2Response
• client.reports.stream_query_fanouts(**params) -> ReportStreamQueryFanoutsResponse
• client.reports.stream_sentiment(**params) -> ReportStreamSentimentResponse
• client.reports.stream_sentiment_v2(**params) -> ReportStreamSentimentV2Response
• client.reports.stream_visibility(**params) -> ReportStreamVisibilityResponse
• client.reports.stream_visibility_v2(**params) -> ReportStreamVisibilityV2Response
• client.reports.visibility(**params) -> ReportResponse

WebSearchResults

Types:

from profound.types.reports import WebSearchResultQueryResponse, WebSearchResultStreamResponse

Methods:

• client.reports.web_search_results.query(**params) -> WebSearchResultQueryResponse
• client.reports.web_search_results.stream(**params) -> WebSearchResultStreamResponse

Shopping

Types:

from profound.types.reports import (
    BrandNameFilter,
    MerchantNameFilter,
    ProductNameFilter,
    ShoppingBrandsResponse,
    ShoppingMerchantsResponse,
    ShoppingProductsResponse,
    ShoppingStreamBrandsResponse,
    ShoppingStreamMerchantsResponse,
    ShoppingStreamProductsResponse,
    ShoppingStreamTriggerRateResponse,
    ShoppingTriggerRateResponse,
)

Methods:

• client.reports.shopping.brands(**params) -> ShoppingBrandsResponse
• client.reports.shopping.merchants(**params) -> ShoppingMerchantsResponse
• client.reports.shopping.products(**params) -> ShoppingProductsResponse
• client.reports.shopping.stream_brands(**params) -> ShoppingStreamBrandsResponse
• client.reports.shopping.stream_merchants(**params) -> ShoppingStreamMerchantsResponse
• client.reports.shopping.stream_products(**params) -> ShoppingStreamProductsResponse
• client.reports.shopping.stream_trigger_rate(**params) -> ShoppingStreamTriggerRateResponse
• client.reports.shopping.trigger_rate(**params) -> ShoppingTriggerRateResponse

Accuracy

Types:

from profound.types.reports import (
    AccuracyCreateBreakdownResponse,
    AccuracyCreateCitationAnalysisResponse,
    AccuracyCreateClaimBreakdownResponse,
    AccuracyCreateClaimCitationsResponse,
    AccuracyCreateClusterExampleRunsResponse,
    AccuracyCreateClusterVerificationPairsResponse,
    AccuracyCreateFactcheckSetupStatusResponse,
    AccuracyCreateInaccuracyDriversResponse,
    AccuracyCreateInaccurateClustersResponse,
    AccuracyCreateInaccurateThemesResponse,
    AccuracyCreateOverviewResponse,
    AccuracyCreateTopInaccurateClaimsResponse,
    AccuracyCreateTopicIDsResponse,
)

Methods:

• client.reports.accuracy.create_breakdown(**params) -> AccuracyCreateBreakdownResponse
• client.reports.accuracy.create_citation_analysis(**params) -> AccuracyCreateCitationAnalysisResponse
• client.reports.accuracy.create_claim_breakdown(**params) -> AccuracyCreateClaimBreakdownResponse
• client.reports.accuracy.create_claim_citations(**params) -> AccuracyCreateClaimCitationsResponse
• client.reports.accuracy.create_cluster_example_runs(**params) -> AccuracyCreateClusterExampleRunsResponse
• client.reports.accuracy.create_cluster_verification_pairs(**params) -> AccuracyCreateClusterVerificationPairsResponse
• client.reports.accuracy.create_factcheck_setup_status(**params) -> AccuracyCreateFactcheckSetupStatusResponse
• client.reports.accuracy.create_inaccuracy_drivers(**params) -> AccuracyCreateInaccuracyDriversResponse
• client.reports.accuracy.create_inaccurate_clusters(**params) -> AccuracyCreateInaccurateClustersResponse
• client.reports.accuracy.create_inaccurate_themes(**params) -> AccuracyCreateInaccurateThemesResponse
• client.reports.accuracy.create_overview(**params) -> AccuracyCreateOverviewResponse
• client.reports.accuracy.create_top_inaccurate_claims(**params) -> AccuracyCreateTopInaccurateClaimsResponse
• client.reports.accuracy.create_topic_ids(**params) -> AccuracyCreateTopicIDsResponse

Factcheck

Types:

from profound.types.reports import FactcheckQueryScoresResponse, FactcheckStreamScoresResponse

Methods:

• client.reports.factcheck.query_scores(**params) -> FactcheckQueryScoresResponse
• client.reports.factcheck.stream_scores(**params) -> FactcheckStreamScoresResponse

Claims

Types:

from profound.types.reports.factcheck import ClaimQueryClaimsResponse, ClaimStreamClaimsResponse

Methods:

• client.reports.factcheck.claims.query_claims(**params) -> ClaimQueryClaimsResponse
• client.reports.factcheck.claims.stream_claims(**params) -> ClaimStreamClaimsResponse

Social

Youtube

Types:

from profound.types.reports.social import (
    YoutubeGetChannelsResponse,
    YoutubeGetSummaryResponse,
    YoutubeGetVideosResponse,
)

Methods:

• client.reports.social.youtube.get_channels(**params) -> YoutubeGetChannelsResponse
• client.reports.social.youtube.get_summary(**params) -> YoutubeGetSummaryResponse
• client.reports.social.youtube.get_videos(**params) -> YoutubeGetVideosResponse

Content

Optimization

Types:

from profound.types.content import OptimizationRetrieveResponse, OptimizationListResponse

Methods:

• client.content.optimization.retrieve(content_id, *, asset_id) -> OptimizationRetrieveResponse
• client.content.optimization.list(asset_id, **params) -> OptimizationListResponse

Agents

Types:

from profound.types import (
    AgentCreateResponse,
    AgentRetrieveResponse,
    AgentUpdateResponse,
    AgentListResponse,
    AgentPublishResponse,
    AgentRetrieveGraphResponse,
)

Methods:

• client.agents.create(**params) -> AgentCreateResponse
• client.agents.retrieve(agent_id, **params) -> AgentRetrieveResponse
• client.agents.update(agent_id, **params) -> AgentUpdateResponse
• client.agents.list(**params) -> AgentListResponse
• client.agents.publish(agent_id) -> AgentPublishResponse
• client.agents.retrieve_graph(agent_id, **params) -> AgentRetrieveGraphResponse

Runs

Types:

from profound.types.agents import RunCreateResponse, RunRetrieveResponse

Methods:

• client.agents.runs.create(agent_id, **params) -> RunCreateResponse
• client.agents.runs.retrieve(run_id, *, agent_id, **params) -> RunRetrieveResponse

NodeTypes

Types:

from profound.types.agents import NodeTypeListResponse, NodeTypeRetrieveSchemaResponse

Methods:

• client.agents.node_types.list() -> NodeTypeListResponse
• client.agents.node_types.retrieve_schema(node_type) -> NodeTypeRetrieveSchemaResponse

KnowledgeBases

Types:

from profound.types import KnowledgeBaseListResponse, KnowledgeBaseSearchResponse

Methods:

• client.knowledge_bases.list(**params) -> KnowledgeBaseListResponse
• client.knowledge_bases.search(knowledge_base_id, **params) -> KnowledgeBaseSearchResponse

Documents

Types:

from profound.types.knowledge_bases import (
    DocumentCreateResponse,
    DocumentUpdateResponse,
    DocumentDeleteResponse,
)

Methods:

• client.knowledge_bases.documents.create(knowledge_base_id, **params) -> DocumentCreateResponse
• client.knowledge_bases.documents.update(knowledge_base_id, **params) -> DocumentUpdateResponse
• client.knowledge_bases.documents.delete(knowledge_base_id, **params) -> DocumentDeleteResponse

Folders

Types:

from profound.types.knowledge_bases import FolderCreateResponse, FolderDeleteResponse

Methods:

• client.knowledge_bases.folders.create(knowledge_base_id, **params) -> FolderCreateResponse
• client.knowledge_bases.folders.delete(knowledge_base_id, **params) -> FolderDeleteResponse

Projects

Types:

from profound.types import (
    ProjectCreateResponse,
    ProjectRetrieveResponse,
    ProjectListResponse,
    ProjectArchiveResponse,
    ProjectGetStatusResponse,
    ProjectUnarchiveResponse,
)

Methods:

• client.projects.create(**params) -> ProjectCreateResponse
• client.projects.retrieve(project_id, **params) -> ProjectRetrieveResponse
• client.projects.list(**params) -> ProjectListResponse
• client.projects.delete(project_id, **params) -> None
• client.projects.archive(project_id, **params) -> ProjectArchiveResponse
• client.projects.get_status(project_id, **params) -> ProjectGetStatusResponse
• client.projects.unarchive(project_id, **params) -> ProjectUnarchiveResponse

Generations

Types:

from profound.types.projects import GenerationRetrieveResponse, GenerationListResponse

Methods:

• client.projects.generations.retrieve(run_id, **params) -> GenerationRetrieveResponse
• client.projects.generations.list(**params) -> GenerationListResponse

Tasks

Types:

from profound.types.projects import (
    TaskCreateResponse,
    TaskRetrieveResponse,
    TaskUpdateResponse,
    TaskListResponse,
    TaskUpdateStatusResponse,
)

Methods:

• client.projects.tasks.create(project_id, **params) -> TaskCreateResponse
• client.projects.tasks.retrieve(task_id, *, project_id, **params) -> TaskRetrieveResponse
• client.projects.tasks.update(task_id, *, project_id, **params) -> TaskUpdateResponse
• client.projects.tasks.list(project_id, **params) -> TaskListResponse
• client.projects.tasks.delete(task_id, *, project_id, **params) -> None
• client.projects.tasks.update_status(task_id, *, project_id, **params) -> TaskUpdateStatusResponse

Integrations

Types:

from profound.types import IntegrationListResponse

Methods:

• client.integrations.list(**params) -> IntegrationListResponse

Documents

Types:

from profound.types import (
    DocumentCreateResponse,
    DocumentRetrieveResponse,
    DocumentUpdateResponse,
    DocumentListResponse,
    DocumentReplaceContentResponse,
)

Methods:

• client.documents.create(**params) -> DocumentCreateResponse
• client.documents.retrieve(document_id, **params) -> DocumentRetrieveResponse
• client.documents.update(document_id, **params) -> DocumentUpdateResponse
• client.documents.list(**params) -> DocumentListResponse
• client.documents.delete(document_id, **params) -> None
• client.documents.replace_content(document_id, **params) -> DocumentReplaceContentResponse

Ads

OpenAIAds

AdAccount

Types:

from profound.types.ads.openai_ads import AdAccountRetrieveInsightsResponse

Methods:

• client.ads.openai_ads.ad_account.retrieve_insights(**params) -> AdAccountRetrieveInsightsResponse