> ## 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 List > Creators 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. 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/creators 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/creators: get: tags: - Creators summary: Creator List description: >- Creators 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. Defaults to the last month when no date range is given. operationId: list_creators 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_CreatorResponse_' '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_CreatorResponse_: properties: data: items: $ref: '#/components/schemas/CreatorResponse' 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[CreatorResponse] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError CreatorResponse: 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 channel_description: type: string nullable: true title: Channel Description thumbnail_url: type: string nullable: true title: Thumbnail Url channel_publish_date: type: string format: date nullable: true title: Channel Publish Date country: type: string nullable: true title: Country channel_type: type: string nullable: true title: Channel Type channel_attributes: items: type: string type: array nullable: true title: Channel Attributes first_seen_at: type: string format: date-time title: First Seen At 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 creator's last known snapshot. influence_score: $ref: '#/components/schemas/Metric' subscriber_count: allOf: - $ref: '#/components/schemas/Metric' nullable: true video_count: allOf: - $ref: '#/components/schemas/Metric' nullable: true view_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 engagement_rate: allOf: - $ref: '#/components/schemas/Metric' nullable: true average_views_per_video: allOf: - $ref: '#/components/schemas/Metric' nullable: true average_likes_per_video: allOf: - $ref: '#/components/schemas/Metric' nullable: true average_comments_per_video: allOf: - $ref: '#/components/schemas/Metric' nullable: true is_active_shorts_creator: type: boolean nullable: true title: Is Active Shorts Creator type: object required: - id - youtube_channel_id - first_seen_at - is_stale - influence_score title: CreatorResponse 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 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 ````