> ## Documentation Index > Fetch the complete documentation index at: https://docs.shareofmodel.ai/llms.txt > Use this file to discover all available pages before exploring further. # Creator Video List > Videos across every project in the workspace, ranked by Influence Score by default. Narrow the results with country, engine, brand, category, analysis (project), and persona filters -- same filter set as the Creator List. Defaults to the last month when no date range is given. ## OpenAPI ````yaml https://openapi.shareofmodel.ai/swagger-sos.json get /v1/organizations/{organization_id}/workspaces/{workspace_id}/search/creator-videos openapi: 3.0.3 info: title: Share Of Model API version: v1 description: >- ## Search The Share of Search API provides visibility, presence, and ranking metrics for tracked search and AI engine sources. Use it to analyse how a project performs across keywords, thematics, competitors, and ranked URLs over time. For the previous version of the API, see the [v1 documentation](https://api.shareofsearch.jplus.io/docs/v1). servers: - description: Search - Production API url: https://api.shareofsearch.jplus.io/ security: [] tags: - name: Projects description: >- Manage analyses (projects) within a workspace. Create new analyses and list existing ones. - name: Collects description: >- Access data collection runs and their raw results. List collect runs for an analysis, or retrieve the raw data captured during each run: domain rankings, brand mentions, keyword insights, and LLM/SERP responses. - name: Overview Metrics description: >- High-level, aggregated metrics that summarise the overall performance of an analysis. Use these endpoints to get a quick picture of visibility, presence, andranking across all keywords and sources. - name: Metrics description: >- Detailed, per-entity metrics for deep-diving into specific aspects of an analysis. Break down performance by domain, brand, keyword, URL, or competitor. - name: Insights description: >- Cross-project KPIs aggregated at the workspace level. These endpoints consolidate metrics from all active projects within a workspace to provide a unified view of visibility, mentions, citations, sentiment, and ranking. - name: Shopping description: >- Shopping-specific metrics for analyses that track product listings in shopping engines. Measure product visibility, pricing, merchant coverage, and share of shelf across all tracked keywords and sources. - name: Creators description: >- YouTube creators cited as sources in AI-engine search results, enriched with channel metrics and an Influence Score. Browse creators across every project in a workspace, narrowed by country, engine, brand, category, analysis, and persona filters. paths: /v1/organizations/{organization_id}/workspaces/{workspace_id}/search/creator-videos: get: tags: - Creators summary: Creator Video List description: >- Videos across every project in the workspace, ranked by Influence Score by default. Narrow the results with country, engine, brand, category, analysis (project), and persona filters -- same filter set as the Creator List. Defaults to the last month when no date range is given. operationId: list_creator_videos parameters: - name: organization_id in: path required: true schema: type: string title: Organization Id - name: workspace_id in: path required: true schema: type: string title: Workspace Id - name: page in: query required: false schema: type: integer minimum: 1 default: 1 title: Page - name: page_size in: query required: false schema: type: integer maximum: 100 minimum: 1 default: 20 title: Page Size - name: date_start in: query required: false schema: type: string format: date nullable: true description: Start of the date range (YYYY-MM-DD). title: Date Start description: Start of the date range (YYYY-MM-DD). - name: date_end in: query required: false schema: type: string format: date nullable: true description: End of the date range (YYYY-MM-DD). title: Date End description: End of the date range (YYYY-MM-DD). - name: sources in: query required: false schema: type: array items: $ref: '#/components/schemas/SourcesEnum' nullable: true description: Filter by engine. title: Sources description: Filter by engine. - name: persona_ids in: query required: false schema: type: array items: type: string nullable: true description: Filter by a list of persona IDs. title: Persona Ids description: Filter by a list of persona IDs. - name: countries in: query required: false schema: type: array items: $ref: '#/components/schemas/CountryCodeEnum' nullable: true description: Filter by country. title: Countries description: Filter by country. - name: brands in: query required: false schema: type: array items: type: string nullable: true description: Filter by brand. title: Brands description: Filter by brand. - name: categories in: query required: false schema: type: array items: type: string nullable: true description: Filter by category. title: Categories description: Filter by category. - name: project_ids in: query required: false schema: type: array items: type: string nullable: true description: Filter by analysis (project) ID. title: Project Ids description: Filter by analysis (project) ID. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginatedResponse_CreatorVideoResponse_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: SourcesEnum: type: string enum: - Bing - BingAIO - ChatGPT - Perplexity - Google - GoogleAIO - GoogleAIMode - Claude - Gemini - AmazonRufus - Grok - Copilot - Mistral title: SourcesEnum CountryCodeEnum: type: string enum: - AR - AT - AU - AE - BH - BE - BO - BR - CA - CN - CO - CR - DK - DO - EC - ES - FI - FR - DE - GB - GT - HK - HU - ID - IE - IL - IN - IT - JP - KR - KW - LU - MA - MX - MY - NG - NL - 'NO' - NZ - PA - PH - PK - PL - PT - QA - RO - SA - SE - SG - CH - TH - TR - TW - US - VN - ZA title: CountryCodeEnum PaginatedResponse_CreatorVideoResponse_: properties: data: items: $ref: '#/components/schemas/CreatorVideoResponse' type: array title: Data description: Items for the current page. pagination: allOf: - $ref: '#/components/schemas/Pagination' description: Pagination metadata. type: object required: - data - pagination title: PaginatedResponse[CreatorVideoResponse] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError CreatorVideoResponse: properties: id: type: string title: Id youtube_video_id: type: string title: Youtube Video Id creator: $ref: '#/components/schemas/CreatorSummaryResponse' first_cited_at: type: string format: date-time title: First Cited At url: type: string nullable: true title: Url title: type: string nullable: true title: Title thumbnail_url: type: string nullable: true title: Thumbnail Url publish_date: type: string format: date nullable: true title: Publish Date description: type: string nullable: true title: Description tags: items: type: string type: array nullable: true title: Tags duration_seconds: type: integer nullable: true title: Duration Seconds has_captions: type: boolean nullable: true title: Has Captions is_licensed_content: type: boolean nullable: true title: Is Licensed Content has_paid_product_placement: type: boolean nullable: true title: Has Paid Product Placement brand_partner_channel_id: type: string nullable: true title: Brand Partner Channel Id brand_partner_channel_handle: type: string nullable: true title: Brand Partner Channel Handle category_id: type: string nullable: true title: Category Id category_name: type: string nullable: true title: Category Name is_stale: type: boolean title: Is Stale description: >- True when no metrics snapshot exists within the selected date range and the values shown fall back to the video's last known snapshot. is_pending: type: boolean title: Is Pending description: >- True when no metrics snapshot has ever been captured for this video yet. influence_score: $ref: '#/components/schemas/Metric' views_count: allOf: - $ref: '#/components/schemas/Metric' nullable: true likes_count: allOf: - $ref: '#/components/schemas/Metric' nullable: true comments_count: allOf: - $ref: '#/components/schemas/Metric' nullable: true type: object required: - id - youtube_video_id - creator - first_cited_at - is_stale - is_pending - influence_score title: CreatorVideoResponse Pagination: properties: page: type: integer title: Page description: Current page number (1-based). page_size: type: integer title: Page Size description: Maximum number of items returned per page. total: type: integer title: Total description: Total number of items matching the query, across all pages. type: object required: - page - page_size - total title: Pagination ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError CreatorSummaryResponse: properties: id: type: string title: Id youtube_channel_id: type: string title: Youtube Channel Id display_name: type: string nullable: true title: Display Name handle: type: string nullable: true title: Handle channel_url: type: string nullable: true title: Channel Url thumbnail_url: type: string nullable: true title: Thumbnail Url type: object required: - id - youtube_channel_id title: CreatorSummaryResponse Metric: properties: value: type: number title: Value description: Current value for the selected period. prev_value: type: number nullable: true title: Prev Value description: >- Value for the previous comparable period. Null when no comparison period is available. unit: type: string nullable: true title: Unit description: >- Unit of the metric (e.g. '%', 'ms'). Null when the value is dimensionless. type: object required: - value title: Metric securitySchemes: HTTPBearer: type: http scheme: bearer ````