{"openapi":"3.1.0","info":{"title":"FastAPI","version":"0.1.0"},"paths":{"/v1/datasets":{"post":{"tags":["public.datasets"],"summary":"Create Dataset","description":"Create a new dataset.\n\nCreates an empty dataset container that can hold mentions collected\nacross multiple runs.\n\n**Parameters:**\n\n- ``name``: human-readable label (1-255 characters).\n\nAfter creation, use ``POST /v1/datasets/{dataset_id}/runs`` to start\na scraping run that populates the dataset with mentions.","operationId":"create_dataset_v1_datasets_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDatasetBody"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseSchema_CreateDatasetResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["public.datasets"],"summary":"List Datasets","description":"List datasets.\n\nReturns a cursor-based paginated list of datasets owned by the\nauthenticated account, sorted by ``created_at``.\n\nSoft-deleted datasets are excluded from the results.\n\n**Query parameters:**\n\n- ``limit``: number of items per page, 1-100 (default 10).\n- ``cursor``: opaque pagination cursor returned in a previous response.\n- ``order``: sort direction -- ``asc`` or ``desc`` (default ``desc``).","operationId":"list_datasets_v1_datasets_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"base64url"},{"type":"null"}],"title":"Cursor"}},{"name":"order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"desc","title":"Order"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CursorBasedPaginatedResponseSchema_DatasetResponse_str_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/datasets/{dataset_id}":{"get":{"tags":["public.datasets"],"summary":"Get Dataset","description":"Retrieve a dataset.\n\nReturns details for a single dataset including its aggregate\n``mentions_count`` across all runs.\n\n**Response fields:**\n\n- ``id``: unique dataset identifier (prefixed with ``ds_``).\n- ``name``: user-defined label.\n- ``mentions_count``: total number of collected mentions across all runs.\n- ``created_at`` / ``updated_at``: timestamps.\n- ``url``: direct link to the dataset in the web UI.\n\nUse ``GET /v1/datasets/{dataset_id}/runs`` to see individual run\nstatuses and parameters.","operationId":"get_dataset_v1_datasets__dataset_id__get","parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseSchema_DatasetResponse_"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__routes__common__responses__schemas____1"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["public.datasets"],"summary":"Update Dataset","description":"Update a dataset.\n\nCurrently the only updatable field is ``name``.\n\n- Sending an empty body is a no-op and returns the current dataset.\n- Setting ``name`` to an empty string clears it (stores ``null``).","operationId":"update_dataset_v1_datasets__dataset_id__patch","parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Dataset Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDatasetBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseSchema_DatasetResponse_"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__routes__common__responses__schemas____2"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["public.datasets"],"summary":"Delete Dataset","description":"Delete a dataset.\n\nPerforms a soft delete. The dataset and all its runs will no longer\nappear in list results and cannot be retrieved by ID after deletion.","operationId":"delete_dataset_v1_datasets__dataset_id__delete","parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Dataset Id"}}],"responses":{"204":{"description":"Successful Response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__routes__common__responses__schemas____3"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/datasets/{dataset_id}/runs":{"post":{"tags":["public.datasets"],"summary":"Create Dataset Run","description":"Create a dataset run.\n\nStarts an asynchronous scraping job that adds mentions to the dataset.\nReturns immediately with the run ID and a ``pending`` status.\n\nA dataset can have multiple runs with different search parameters,\neach adding its own set of mentions.\n\n**Parameters:**\n\n- ``search_query``: the search query to use. Two types are supported:\n  ``prompt`` (search by keyword query across selected platforms, requires\n  ``sources`` and ``search_query`` of 1-5000 characters) and ``url``\n  (scrape specific URLs directly, provide ``source_urls`` with ``source``,\n  ``url``, and optional ``text`` for Reddit, maximum 100 URLs per run).\n- ``count``: number of posts to collect, 20-1000 (default 200).\n- ``num_comments_per_post``: 0-100 (default 10).\n- ``date_range``: optional date window validated against your subscription\n  plan limits. The ``from`` date must be before ``to``, and the range must\n  not exceed the plan's maximum time span.\n- ``country_code``: ISO 3166-1 alpha-2 code (default ``US``).\n- ``language``: BCP-47 language tag (optional).\n- ``enable_visual_recognition``: analyse images in posts (default false).\n- ``enable_transcribing``: transcribe audio/video (default false).\n- ``content_analysis_actions``: list of analysis actions to run\n  (``content_category``, ``tone_of_voice``, ``narrative_structure``,\n  ``intent``, ``hook``, ``mentioned_brands``, ``topics``, ``emotions``,\n  ``cta``, ``entities``, ``questions``, ``sentiment``, ``signal``).\n\nPoll ``GET /v1/datasets/{dataset_id}/runs/{run_id}`` to track progress.","operationId":"create_dataset_run_v1_datasets__dataset_id__runs_post","parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Dataset Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDatasetRunBody"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseSchema_CreateDatasetRunResponse_"}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__routes__common__responses__schemas____4"}}},"description":"Payment Required"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__routes__common__responses__schemas____5"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api__routes__common__responses__schemas____6"},{"$ref":"#/components/schemas/api__routes__common__responses__schemas____7"},{"$ref":"#/components/schemas/api__routes__common__responses__schemas____8"},{"$ref":"#/components/schemas/api__routes__common__responses__schemas____9"},{"$ref":"#/components/schemas/api__routes__common__responses__schemas____10"},{"$ref":"#/components/schemas/api__routes__common__responses__schemas____11"}],"title":"Response 422 Create Dataset Run V1 Datasets  Dataset Id  Runs Post"}}},"description":"Unprocessable Entity"}}},"get":{"tags":["public.datasets"],"summary":"List Dataset Runs","description":"List runs for a dataset.\n\nReturns a cursor-based paginated list of runs belonging to the\ndataset, sorted by ``created_at``.\n\nEach run includes its own ``status``, ``params``, and ``mentions_count``.\n\n**Query parameters:**\n\n- ``limit``: number of items per page, 1-100 (default 10).\n- ``cursor``: opaque pagination cursor returned in a previous response.\n- ``order``: sort direction -- ``asc`` or ``desc`` (default ``desc``).","operationId":"list_dataset_runs_v1_datasets__dataset_id__runs_get","parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Dataset Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"base64url"},{"type":"null"}],"title":"Cursor"}},{"name":"order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"desc","title":"Order"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CursorBasedPaginatedResponseSchema_DatasetRunResponse_str_"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__routes__common__responses__schemas____12"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/datasets/{dataset_id}/runs/{run_id}":{"get":{"tags":["public.datasets"],"summary":"Get Dataset Run","description":"Retrieve a dataset run.\n\nReturns full details for a single run, including its processing status\nand the search parameters used.\n\n**Response fields:**\n\n- ``id``: unique run identifier (prefixed with ``dr_``).\n- ``dataset_id``: the parent dataset.\n- ``status``: processing status object. The ``type`` field is one of\n  ``pending``, ``working``, ``completed``, or ``failed``.  A ``failed``\n  status includes an ``error_message``.\n- ``params``: the search parameters used for this run.\n- ``mentions_count``: number of mentions collected by this run.\n- ``created_at`` / ``updated_at``: timestamps.","operationId":"get_dataset_run_v1_datasets__dataset_id__runs__run_id__get","parameters":[{"name":"dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Dataset Id"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseSchema_DatasetRunResponse_"}}}},"404":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api__routes__common__responses__schemas____13"},{"$ref":"#/components/schemas/api__routes__common__responses__schemas____14"}],"title":"Response 404 Get Dataset Run V1 Datasets  Dataset Id  Runs  Run Id  Get"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audience_datasets":{"post":{"tags":["public.audience_datasets"],"summary":"Create Audience Dataset","description":"Create an audience-dataset container.\n\nAudience datasets are name-only buckets that hold audience-collection\nruns. Each run is bound to a specific source dataset at run-creation\ntime -- runs in the same container can target different source\ndatasets over time.\n\n**Parameters:**\n\n- ``name``: human-readable label (1-255 characters).\n\n**Status codes:**\n\n- 400 when the calling account's plan does not include audience\n  research.\n\nAfter creation, use ``POST /v1/audience_datasets/{audience_dataset_id}/runs``\nto start a profile-collection run.","operationId":"create_audience_dataset_v1_audience_datasets_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAudienceDatasetBody"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseSchema_CreateAudienceDatasetResponse_"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__routes__common__responses__schemas____15"}}},"description":"Bad Request"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["public.audience_datasets"],"summary":"List Audience Datasets","description":"List audience datasets.\n\nReturns a cursor-based paginated list of audience datasets owned by\nthe authenticated account, sorted by ``created_at``.\n\nSoft-deleted audience datasets are excluded from the results.\n\n**Query parameters:**\n\n- ``limit``: number of items per page, 1-100 (default 10).\n- ``cursor``: opaque pagination cursor returned in a previous response.\n- ``order``: sort direction -- ``asc`` or ``desc`` (default ``desc``).","operationId":"list_audience_datasets_v1_audience_datasets_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"base64url"},{"type":"null"}],"title":"Cursor"}},{"name":"order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"desc","title":"Order"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CursorBasedPaginatedResponseSchema_AudienceDatasetResponse_str_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audience_datasets/{audience_dataset_id}":{"get":{"tags":["public.audience_datasets"],"summary":"Get Audience Dataset","description":"Retrieve an audience dataset.\n\nReturns details for a single audience dataset, including its\n``profile_count`` (number of unique profiles in the latest completed\nrun).\n\n**Response fields:**\n\n- ``id``: unique audience-dataset identifier (prefixed with ``ad_``).\n- ``name``: user-defined label.\n- ``profile_count``: number of profiles in the latest completed run.\n- ``created_at`` / ``updated_at``: timestamps.","operationId":"get_audience_dataset_v1_audience_datasets__audience_dataset_id__get","parameters":[{"name":"audience_dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Audience Dataset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseSchema_AudienceDatasetResponse_"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__routes__common__responses__schemas____16"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["public.audience_datasets"],"summary":"Update Audience Dataset","description":"Update an audience dataset.\n\nCurrently the only updatable field is ``name``.\n\n- Sending an empty body is a no-op and returns the current row.\n- Setting ``name`` to an empty string clears it (stores ``null``).","operationId":"update_audience_dataset_v1_audience_datasets__audience_dataset_id__patch","parameters":[{"name":"audience_dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Audience Dataset Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAudienceDatasetBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseSchema_AudienceDatasetResponse_"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__routes__common__responses__schemas____17"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["public.audience_datasets"],"summary":"Delete Audience Dataset","description":"Delete an audience dataset.\n\nPerforms a soft delete. The audience dataset and all its runs will no\nlonger appear in list results and cannot be retrieved by ID after\ndeletion.","operationId":"delete_audience_dataset_v1_audience_datasets__audience_dataset_id__delete","parameters":[{"name":"audience_dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Audience Dataset Id"}}],"responses":{"204":{"description":"Successful Response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__routes__common__responses__schemas____18"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audience_datasets/{audience_dataset_id}/runs":{"post":{"tags":["public.audience_datasets"],"summary":"Create Audience Dataset Run","description":"Create an audience-dataset run.\n\nStarts an asynchronous profile-collection job. Returns immediately\nwith the run ID and a ``pending`` status.\n\n**Parameters:**\n\n- ``source_dataset_id``: a dataset owned by the calling account that\n  has at least one ``completed`` run; the audience pipeline reads\n  that dataset's posts to seed profile collection.\n- ``total_profile_count``: target number of profiles to collect,\n  1-2000 (default 850).\n\n**Status codes:**\n\n- 404 when the audience dataset or source dataset cannot be found.\n- 400 when the source dataset has no completed runs, or when the\n  calling account's plan does not include audience research.\n- 409 when another run on this audience dataset is already pending\n  or working.\n- 402 when the account does not have enough credits.\n\nPoll ``GET /v1/audience_datasets/{audience_dataset_id}/runs/{run_id}``\nto track progress.","operationId":"create_audience_dataset_run_v1_audience_datasets__audience_dataset_id__runs_post","parameters":[{"name":"audience_dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Audience Dataset Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAudienceDatasetRunBody"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseSchema_CreateAudienceDatasetRunResponse_"}}}},"400":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api__routes__common__responses__schemas____19"},{"$ref":"#/components/schemas/api__routes__common__responses__schemas____20"}],"title":"Response 400 Create Audience Dataset Run V1 Audience Datasets  Audience Dataset Id  Runs Post"}}},"description":"Bad Request"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__routes__common__responses__schemas____21"}}},"description":"Payment Required"},"404":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api__routes__common__responses__schemas____22"},{"$ref":"#/components/schemas/api__routes__common__responses__schemas____23"}],"title":"Response 404 Create Audience Dataset Run V1 Audience Datasets  Audience Dataset Id  Runs Post"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__routes__common__responses__schemas____24"}}},"description":"Conflict"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["public.audience_datasets"],"summary":"List Audience Dataset Runs","description":"List runs for an audience dataset.\n\nReturns a cursor-based paginated list of runs belonging to the\naudience dataset, sorted by ``created_at``.\n\nEach run includes its own ``status``, ``source_dataset_id``,\n``target_profile_count`` and ``profile_count`` (rows collected so far).\n\n**Query parameters:**\n\n- ``limit``: number of items per page, 1-100 (default 10).\n- ``cursor``: opaque pagination cursor returned in a previous response.\n- ``order``: sort direction -- ``asc`` or ``desc`` (default ``desc``).","operationId":"list_audience_dataset_runs_v1_audience_datasets__audience_dataset_id__runs_get","parameters":[{"name":"audience_dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Audience Dataset Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"base64url"},{"type":"null"}],"title":"Cursor"}},{"name":"order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"desc","title":"Order"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CursorBasedPaginatedResponseSchema_AudienceDatasetRunResponse_str_"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__routes__common__responses__schemas____25"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audience_datasets/{audience_dataset_id}/runs/{run_id}":{"get":{"tags":["public.audience_datasets"],"summary":"Get Audience Dataset Run","description":"Retrieve an audience-dataset run.\n\nReturns full details for a single run.\n\n**Response fields:**\n\n- ``id``: unique run identifier (prefixed with ``adr_``).\n- ``audience_dataset_id``: the parent audience dataset.\n- ``source_dataset_id``: the source dataset whose posts seeded this\n  run.\n- ``status``: processing status object. The ``type`` field is one of\n  ``pending``, ``working``, ``completed`` or ``failed``. A ``failed``\n  status includes an ``error_message``.\n- ``target_profile_count``: target profile count for this run.\n- ``profile_count``: number of profiles collected so far.\n- ``created_at`` / ``updated_at``: timestamps.","operationId":"get_audience_dataset_run_v1_audience_datasets__audience_dataset_id__runs__run_id__get","parameters":[{"name":"audience_dataset_id","in":"path","required":true,"schema":{"type":"string","title":"Audience Dataset Id"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseSchema_AudienceDatasetRunResponse_"}}}},"404":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/api__routes__common__responses__schemas____26"},{"$ref":"#/components/schemas/api__routes__common__responses__schemas____27"}],"title":"Response 404 Get Audience Dataset Run V1 Audience Datasets  Audience Dataset Id  Runs  Run Id  Get"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mentions":{"post":{"tags":["public.mentions"],"summary":"List Mentions","description":"List mentions across one or more datasets owned by the account.\n\nAccount scoping is implicit via the API key. ``dataset_ids`` is\noptional:\n\n- When omitted, the endpoint returns mentions from every dataset\n  owned by the calling account.\n- When provided, every id must belong to the calling account or the\n  response is 404.\n\n``operation`` (spec §4.6) toggles between paginated mention rows\n(``select``, the default) and a bare ``{count}`` response\n(``count`` -- skips pagination/hydration; ``cursor`` and ``limit``\nare ignored). Same body shape, same filter compilation.\n\n**Filtering, sorting, pagination** mirror\n``POST /v1/datasets/{dataset_id}/mentions`` (now removed): see the\ndocs section on filter groups for details. Each ``Mention`` carries a\n``datasets`` list with ``{ id, name }`` of every dataset that\ncontains it -- the same post can show up in multiple datasets.\n\n``q`` + ``search_mode`` (spec §4.7) enable hybrid keyword/semantic\nsearch. ``search_mode='keyword'`` (default) adds a tsvector predicate\nover title/text/transcriptions when ``q`` is set, and is a no-op when\n``q`` is null. ``search_mode='semantic'`` requires ``q`` and ranks\ncandidates via the ai-assistant Qdrant index.","operationId":"list_mentions_v1_mentions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListMentionsBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CursorBasedPaginatedResponseSchema_Mention_str_"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__routes__common__responses__schemas____28"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audience_profiles":{"post":{"tags":["public.audience_profiles"],"summary":"List Audience Profiles","description":"List audience profiles across one or more audience datasets.\n\nAccount scoping is implicit via the API key.\n``audience_dataset_ids`` is optional:\n\n- When omitted, returns profiles from every audience dataset owned\n  by the calling account.\n- When provided, every id must belong to the calling account or the\n  response is 404.\n\nProfiles are deduped by ``(source, username)`` keeping the most\nrecent row -- this matches the per-audience-dataset profiles\nendpoint's invariant.","operationId":"list_audience_profiles_v1_audience_profiles_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAudienceProfilesBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CursorBasedPaginatedResponseSchema_AudienceProfileItem_str_"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__routes__common__responses__schemas____29"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AudienceDatasetResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"profile_count":{"type":"integer","title":"Profile Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","profile_count","created_at","updated_at"],"title":"AudienceDatasetResponse","description":"Container view for an audience dataset.\n\nNo ``url`` field — there is no FE detail page for audience datasets in\nv1; the public API surface intentionally omits it."},"AudienceDatasetRunResponse":{"properties":{"id":{"type":"string","title":"Id"},"audience_dataset_id":{"type":"string","title":"Audience Dataset Id"},"source_dataset_id":{"type":"string","title":"Source Dataset Id"},"status":{"$ref":"#/components/schemas/RunStatusEnvelope"},"target_profile_count":{"type":"integer","title":"Target Profile Count"},"profile_count":{"type":"integer","title":"Profile Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","audience_dataset_id","source_dataset_id","status","target_profile_count","profile_count","created_at","updated_at"],"title":"AudienceDatasetRunResponse"},"AudienceProfileItem":{"properties":{"id":{"type":"string","title":"Id"},"run_id":{"type":"string","title":"Run Id"},"source":{"$ref":"#/components/schemas/SearchSource"},"username":{"type":"string","title":"Username"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"avatar":{"anyOf":[{"$ref":"#/components/schemas/Image"},{"type":"null"}]},"bio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio"},"external_link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Link"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Verified"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Follower Count"},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Following Count"},"content_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Content Count"},"engagement_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Engagement Rate"},"posting_cadence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Posting Cadence"},"creator_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creator Tier"},"location_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Country"},"location_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location City"},"primary_language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Language"},"authenticity_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Authenticity Score"},"authenticity_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authenticity Reason"},"aesthetic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aesthetic"},"communication_tone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Communication Tone"},"content_niche":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Content Niche"},"interest_clusters":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Interest Clusters"},"brand_affinities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Brand Affinities"},"occupation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Occupation"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"},"ocean":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ocean"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Score"},"platform_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Platform Metadata"},"created_at":{"type":"integer","title":"Created At"}},"type":"object","required":["id","run_id","source","username","display_name","avatar","bio","external_link","is_verified","follower_count","following_count","content_count","engagement_rate","posting_cadence","creator_tier","location_country","location_city","primary_language","authenticity_score","authenticity_reason","aesthetic","communication_tone","content_niche","interest_clusters","brand_affinities","occupation","industry","ocean","summary","score","platform_metadata","created_at"],"title":"AudienceProfileItem"},"AudienceProfilesSortType":{"type":"string","enum":["date","follower_count","following_count","content_count","engagement_rate","score","authenticity_score","creator_tier"],"title":"AudienceProfilesSortType"},"AuthenticityScoreFilter":{"properties":{"type":{"type":"string","const":"authenticity_score","title":"Type","default":"authenticity_score"},"operator":{"oneOf":[{"$ref":"#/components/schemas/RangeGreaterThanOperator"},{"$ref":"#/components/schemas/RangeLessThanOperator"},{"$ref":"#/components/schemas/RangeInRangeOperator"}],"title":"Operator","discriminator":{"propertyName":"type","mapping":{"greater_than":"#/components/schemas/RangeGreaterThanOperator","in_range":"#/components/schemas/RangeInRangeOperator","less_than":"#/components/schemas/RangeLessThanOperator"}}}},"type":"object","required":["operator"],"title":"AuthenticityScoreFilter"},"CollectionIdsFilter":{"properties":{"type":{"type":"string","const":"collection_id","title":"Type","default":"collection_id"},"values":{"items":{"type":"integer"},"type":"array","maxItems":100,"minItems":1,"title":"Values"}},"type":"object","required":["values"],"title":"CollectionIdsFilter"},"ComparisonPeriod":{"type":"string","enum":["past_day","past_week","past_month"],"title":"ComparisonPeriod"},"CompletedStep":{"properties":{"name":{"type":"string","title":"Name"},"completed_at":{"type":"integer","title":"Completed At"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"}},"type":"object","required":["name","completed_at"],"title":"CompletedStep"},"ContentAnalysisAction":{"type":"string","enum":["content_category","tone_of_voice","narrative_structure","intent","hook","mentioned_brands","content_topics","emotions","cta","entities","questions","sentiment","language"],"title":"ContentAnalysisAction"},"ContentIntentionFilter":{"properties":{"type":{"type":"string","const":"content_intention","title":"Type","default":"content_intention"},"operator":{"type":"string","const":"any_of","title":"Operator","default":"any_of"},"values":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Values"}},"type":"object","required":["values"],"title":"ContentIntentionFilter"},"ContentNicheFilter":{"properties":{"type":{"type":"string","const":"content_niche","title":"Type","default":"content_niche"},"operator":{"type":"string","const":"any_of","title":"Operator","default":"any_of"},"values":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Values"}},"type":"object","required":["values"],"title":"ContentNicheFilter"},"ContentSignal":{"properties":{"text":{"type":"string","title":"Text"}},"type":"object","required":["text"],"title":"ContentSignal","description":"Labeled signal from content analysis (tone of voice, hook, CTA, etc.)."},"ContentTopicFilter":{"properties":{"type":{"type":"string","const":"content_topic","title":"Type","default":"content_topic"},"operator":{"type":"string","const":"any_of","title":"Operator","default":"any_of"},"values":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Values"}},"type":"object","required":["values"],"title":"ContentTopicFilter"},"CountryCodeFilter":{"properties":{"type":{"type":"string","const":"country_code","title":"Type","default":"country_code"},"values":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Values"}},"type":"object","required":["values"],"title":"CountryCodeFilter"},"CreateAudienceDatasetBody":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"}},"type":"object","required":["name"],"title":"CreateAudienceDatasetBody"},"CreateAudienceDatasetResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","name","created_at"],"title":"CreateAudienceDatasetResponse"},"CreateAudienceDatasetRunBody":{"properties":{"source_dataset_id":{"type":"string","title":"Source Dataset Id"},"total_profile_count":{"type":"integer","maximum":2000.0,"minimum":1.0,"title":"Total Profile Count","default":850}},"type":"object","required":["source_dataset_id"],"title":"CreateAudienceDatasetRunBody"},"CreateAudienceDatasetRunResponse":{"properties":{"id":{"type":"string","title":"Id"},"audience_dataset_id":{"type":"string","title":"Audience Dataset Id"},"source_dataset_id":{"type":"string","title":"Source Dataset Id"},"status":{"$ref":"#/components/schemas/RunStatusEnvelope"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","audience_dataset_id","source_dataset_id","status","created_at"],"title":"CreateAudienceDatasetRunResponse"},"CreateDatasetBody":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"}},"type":"object","required":["name"],"title":"CreateDatasetBody"},"CreateDatasetResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","name","created_at"],"title":"CreateDatasetResponse"},"CreateDatasetRunBody":{"properties":{"search_query":{"oneOf":[{"$ref":"#/components/schemas/PromptDatasetSearchQuery"},{"$ref":"#/components/schemas/URLDatasetSearchQuery-Input"}],"title":"Search Query","discriminator":{"propertyName":"type","mapping":{"prompt":"#/components/schemas/PromptDatasetSearchQuery","url":"#/components/schemas/URLDatasetSearchQuery-Input"}}},"count":{"type":"integer","maximum":1000.0,"minimum":20.0,"title":"Count","default":200},"num_comments_per_post":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Num Comments Per Post","default":10},"date_range":{"anyOf":[{"$ref":"#/components/schemas/DateRange"},{"type":"null"}]},"country_code":{"type":"string","title":"Country Code","default":"US"},"language":{"anyOf":[{"$ref":"#/components/schemas/Language"},{"type":"null"}]},"enable_visual_recognition":{"type":"boolean","title":"Enable Visual Recognition","default":false},"enable_transcribing":{"type":"boolean","title":"Enable Transcribing","default":false},"content_analysis_actions":{"items":{"$ref":"#/components/schemas/ContentAnalysisAction"},"type":"array","title":"Content Analysis Actions","default":[]}},"type":"object","required":["search_query"],"title":"CreateDatasetRunBody"},"CreateDatasetRunResponse":{"properties":{"id":{"type":"string","title":"Id"},"dataset_id":{"type":"string","title":"Dataset Id"},"status":{"$ref":"#/components/schemas/RunStatusEnvelope"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","dataset_id","status","created_at"],"title":"CreateDatasetRunResponse"},"CreatorTierFilter":{"properties":{"type":{"type":"string","const":"creator_tier","title":"Type","default":"creator_tier"},"values":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Values"}},"type":"object","required":["values"],"title":"CreatorTierFilter"},"CtaFilter":{"properties":{"type":{"type":"string","const":"cta","title":"Type","default":"cta"},"operator":{"type":"string","const":"any_of","title":"Operator","default":"any_of"},"values":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Values"}},"type":"object","required":["values"],"title":"CtaFilter"},"CursorBasedPaginatedResponseSchema_AudienceDatasetResponse_str_":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType"},"data":{"items":{"$ref":"#/components/schemas/AudienceDatasetResponse"},"type":"array","title":"Data"},"has_next":{"type":"boolean","title":"Has Next"},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},"type":"object","required":["status","data","has_next","cursor"],"title":"CursorBasedPaginatedResponseSchema[AudienceDatasetResponse, str]"},"CursorBasedPaginatedResponseSchema_AudienceDatasetRunResponse_str_":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType"},"data":{"items":{"$ref":"#/components/schemas/AudienceDatasetRunResponse"},"type":"array","title":"Data"},"has_next":{"type":"boolean","title":"Has Next"},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},"type":"object","required":["status","data","has_next","cursor"],"title":"CursorBasedPaginatedResponseSchema[AudienceDatasetRunResponse, str]"},"CursorBasedPaginatedResponseSchema_AudienceProfileItem_str_":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType"},"data":{"items":{"$ref":"#/components/schemas/AudienceProfileItem"},"type":"array","title":"Data"},"has_next":{"type":"boolean","title":"Has Next"},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},"type":"object","required":["status","data","has_next","cursor"],"title":"CursorBasedPaginatedResponseSchema[AudienceProfileItem, str]"},"CursorBasedPaginatedResponseSchema_DatasetResponse_str_":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType"},"data":{"items":{"$ref":"#/components/schemas/DatasetResponse"},"type":"array","title":"Data"},"has_next":{"type":"boolean","title":"Has Next"},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},"type":"object","required":["status","data","has_next","cursor"],"title":"CursorBasedPaginatedResponseSchema[DatasetResponse, str]"},"CursorBasedPaginatedResponseSchema_DatasetRunResponse_str_":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType"},"data":{"items":{"$ref":"#/components/schemas/DatasetRunResponse"},"type":"array","title":"Data"},"has_next":{"type":"boolean","title":"Has Next"},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},"type":"object","required":["status","data","has_next","cursor"],"title":"CursorBasedPaginatedResponseSchema[DatasetRunResponse, str]"},"CursorBasedPaginatedResponseSchema_Mention_str_":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType"},"data":{"items":{"$ref":"#/components/schemas/Mention"},"type":"array","title":"Data"},"has_next":{"type":"boolean","title":"Has Next"},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},"type":"object","required":["status","data","has_next","cursor"],"title":"CursorBasedPaginatedResponseSchema[Mention, str]"},"DatasetIdsFilter":{"properties":{"type":{"type":"string","const":"dataset_id","title":"Type","default":"dataset_id"},"values":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Values"}},"type":"object","required":["values"],"title":"DatasetIdsFilter"},"DatasetResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"mentions_count":{"type":"integer","title":"Mentions Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"url":{"type":"string","title":"Url"}},"type":"object","required":["id","name","mentions_count","created_at","updated_at","url"],"title":"DatasetResponse"},"DatasetRunParams":{"properties":{"search_query":{"oneOf":[{"$ref":"#/components/schemas/PromptDatasetSearchQuery"},{"$ref":"#/components/schemas/URLDatasetSearchQuery-Output"}],"title":"Search Query","discriminator":{"propertyName":"type","mapping":{"prompt":"#/components/schemas/PromptDatasetSearchQuery","url":"#/components/schemas/URLDatasetSearchQuery-Output"}}},"date_range":{"anyOf":[{"$ref":"#/components/schemas/DateRange"},{"type":"null"}]},"country_code":{"type":"string","title":"Country Code"},"language":{"anyOf":[{"$ref":"#/components/schemas/Language"},{"type":"null"}]},"count":{"type":"integer","title":"Count"},"num_comments_per_post":{"type":"integer","title":"Num Comments Per Post"},"enable_visual_recognition":{"type":"boolean","title":"Enable Visual Recognition"},"enable_transcribing":{"type":"boolean","title":"Enable Transcribing"},"content_analysis_actions":{"items":{"$ref":"#/components/schemas/ContentAnalysisAction"},"type":"array","title":"Content Analysis Actions"}},"type":"object","required":["search_query","date_range","country_code","language","count","num_comments_per_post","enable_visual_recognition","enable_transcribing","content_analysis_actions"],"title":"DatasetRunParams"},"DatasetRunResponse":{"properties":{"id":{"type":"string","title":"Id"},"dataset_id":{"type":"string","title":"Dataset Id"},"status":{"$ref":"#/components/schemas/RunStatusEnvelope"},"params":{"$ref":"#/components/schemas/DatasetRunParams"},"mentions_count":{"type":"integer","title":"Mentions Count"},"new_mentions_count":{"type":"integer","title":"New Mentions Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","dataset_id","status","params","mentions_count","new_mentions_count","created_at","updated_at"],"title":"DatasetRunResponse"},"DatasetSourceURL":{"properties":{"source":{"$ref":"#/components/schemas/SearchSource"},"url":{"type":"string","title":"Url"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"}},"type":"object","required":["source","url"],"title":"DatasetSourceURL"},"DateRange":{"properties":{"from":{"type":"string","format":"date","title":"From"},"to":{"type":"string","format":"date","title":"To"}},"type":"object","required":["from","to"],"title":"DateRange"},"DominantEmotion":{"type":"string","enum":["neutral","joy","sadness","anger","surprise","disgust","fear"],"title":"DominantEmotion"},"DominantEmotionFilter":{"properties":{"type":{"type":"string","const":"dominant_emotion","title":"Type","default":"dominant_emotion"},"values":{"items":{"$ref":"#/components/schemas/DominantEmotion"},"type":"array","minItems":1,"title":"Values"}},"type":"object","required":["values"],"title":"DominantEmotionFilter"},"EngagementRateFilter":{"properties":{"type":{"type":"string","const":"engagement_rate","title":"Type","default":"engagement_rate"},"operator":{"oneOf":[{"$ref":"#/components/schemas/RangeGreaterThanOperator"},{"$ref":"#/components/schemas/RangeLessThanOperator"},{"$ref":"#/components/schemas/RangeInRangeOperator"}],"title":"Operator","discriminator":{"propertyName":"type","mapping":{"greater_than":"#/components/schemas/RangeGreaterThanOperator","in_range":"#/components/schemas/RangeInRangeOperator","less_than":"#/components/schemas/RangeLessThanOperator"}}}},"type":"object","required":["operator"],"title":"EngagementRateFilter"},"FailedStep":{"properties":{"name":{"type":"string","title":"Name"},"failed_at":{"type":"integer","title":"Failed At"}},"type":"object","required":["name","failed_at"],"title":"FailedStep"},"FollowerCountFilter":{"properties":{"type":{"type":"string","const":"follower_count","title":"Type","default":"follower_count"},"operator":{"oneOf":[{"$ref":"#/components/schemas/RangeGreaterThanOperator"},{"$ref":"#/components/schemas/RangeLessThanOperator"},{"$ref":"#/components/schemas/RangeInRangeOperator"}],"title":"Operator","discriminator":{"propertyName":"type","mapping":{"greater_than":"#/components/schemas/RangeGreaterThanOperator","in_range":"#/components/schemas/RangeInRangeOperator","less_than":"#/components/schemas/RangeLessThanOperator"}}}},"type":"object","required":["operator"],"title":"FollowerCountFilter"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HasMediaFilter":{"properties":{"type":{"type":"string","const":"has_media","title":"Type","default":"has_media"},"value":{"type":"boolean","title":"Value"}},"type":"object","required":["value"],"title":"HasMediaFilter"},"HookFilter":{"properties":{"type":{"type":"string","const":"hook","title":"Type","default":"hook"},"operator":{"type":"string","const":"any_of","title":"Operator","default":"any_of"},"values":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Values"}},"type":"object","required":["values"],"title":"HookFilter"},"Image":{"properties":{"type":{"type":"string","const":"image","title":"Type","default":"image"},"version_list":{"items":{"$ref":"#/components/schemas/ImageVersion"},"type":"array","title":"Version List"},"description":{"type":"string","title":"Description","default":""}},"type":"object","required":["version_list"],"title":"Image"},"ImageVersion":{"properties":{"url":{"type":"string","title":"Url"},"width":{"type":"integer","title":"Width"},"height":{"type":"integer","title":"Height"}},"type":"object","required":["url","width","height"],"title":"ImageVersion"},"InterestClustersFilter":{"properties":{"type":{"type":"string","const":"interest_clusters","title":"Type","default":"interest_clusters"},"operator":{"type":"string","const":"any_of","title":"Operator","default":"any_of"},"values":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Values"}},"type":"object","required":["values"],"title":"InterestClustersFilter"},"IsVerifiedFilter":{"properties":{"type":{"type":"string","const":"is_verified","title":"Type","default":"is_verified"},"value":{"type":"boolean","title":"Value"}},"type":"object","required":["value"],"title":"IsVerifiedFilter"},"KeywordFilter":{"properties":{"type":{"type":"string","const":"keyword","title":"Type","default":"keyword"},"operator":{"$ref":"#/components/schemas/KeywordFilterOperator"},"value":{"type":"string","maxLength":500,"minLength":1,"title":"Value"}},"type":"object","required":["operator","value"],"title":"KeywordFilter"},"KeywordFilterOperator":{"type":"string","enum":["is","is_not"],"title":"KeywordFilterOperator"},"Language":{"type":"string","enum":["ar","hy","bg","ca","cs","da","de","el","en","es","et","tl","fi","fr","hr","hi","hu","id","is","it","iw","he","ja","ko","lt","lv","nl","no","fa","pl","pt","ro","ru","sk","sl","sr","sv","th","tr","uk","vi","zh-CN","zh-TW"],"title":"Language"},"ListAudienceProfilesBody":{"properties":{"audience_dataset_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Audience Dataset Ids","description":"Optional list of audience-dataset ids to scope the search. When omitted, the endpoint returns profiles across every audience dataset owned by the calling account."},"sort":{"$ref":"#/components/schemas/AudienceProfilesSortType","default":"date"},"order":{"type":"string","enum":["asc","desc"],"title":"Order","default":"desc"},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":20},"filters":{"anyOf":[{"items":{"items":{"oneOf":[{"$ref":"#/components/schemas/SourceFilter"},{"$ref":"#/components/schemas/IsVerifiedFilter"},{"$ref":"#/components/schemas/LocationCountryFilter"},{"$ref":"#/components/schemas/CreatorTierFilter"},{"$ref":"#/components/schemas/ContentNicheFilter"},{"$ref":"#/components/schemas/InterestClustersFilter"},{"$ref":"#/components/schemas/FollowerCountFilter"},{"$ref":"#/components/schemas/EngagementRateFilter"},{"$ref":"#/components/schemas/AuthenticityScoreFilter"}],"discriminator":{"propertyName":"type","mapping":{"authenticity_score":"#/components/schemas/AuthenticityScoreFilter","content_niche":"#/components/schemas/ContentNicheFilter","creator_tier":"#/components/schemas/CreatorTierFilter","engagement_rate":"#/components/schemas/EngagementRateFilter","follower_count":"#/components/schemas/FollowerCountFilter","interest_clusters":"#/components/schemas/InterestClustersFilter","is_verified":"#/components/schemas/IsVerifiedFilter","location_country":"#/components/schemas/LocationCountryFilter","source":"#/components/schemas/SourceFilter"}}},"type":"array","minItems":1},"type":"array","minItems":1,"description":"List of filter groups combined with OR. Filters within each group are combined with AND. Maximum 10 filters total."},{"type":"null"}],"title":"Filters"}},"type":"object","title":"ListAudienceProfilesBody"},"ListMentionsBody":{"properties":{"dataset_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Dataset Ids","description":"Optional list of dataset ids to scope the search. When omitted, the endpoint returns mentions across every dataset owned by the calling account."},"operation":{"$ref":"#/components/schemas/MentionsOperation","default":"select"},"sources":{"anyOf":[{"items":{"$ref":"#/components/schemas/SearchSource"},"type":"array"},{"type":"null"}],"title":"Sources"},"sort":{"$ref":"#/components/schemas/MentionsSortType","default":"date"},"order":{"type":"string","enum":["asc","desc"],"title":"Order","default":"desc"},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":20},"filters":{"anyOf":[{"items":{"items":{"oneOf":[{"$ref":"#/components/schemas/KeywordFilter"},{"$ref":"#/components/schemas/SentimentFilter"},{"$ref":"#/components/schemas/MetricChangeFilter"},{"$ref":"#/components/schemas/SourceFilter"},{"$ref":"#/components/schemas/ContentTopicFilter"},{"$ref":"#/components/schemas/ContentIntentionFilter"},{"$ref":"#/components/schemas/ToneOfVoiceFilter"},{"$ref":"#/components/schemas/HookFilter"},{"$ref":"#/components/schemas/CtaFilter"},{"$ref":"#/components/schemas/MentionedBrandsFilter"},{"$ref":"#/components/schemas/CountryCodeFilter"},{"$ref":"#/components/schemas/HasMediaFilter"},{"$ref":"#/components/schemas/DominantEmotionFilter"},{"$ref":"#/components/schemas/DatasetIdsFilter"},{"$ref":"#/components/schemas/CollectionIdsFilter"}],"discriminator":{"propertyName":"type","mapping":{"collection_id":"#/components/schemas/CollectionIdsFilter","content_intention":"#/components/schemas/ContentIntentionFilter","content_topic":"#/components/schemas/ContentTopicFilter","country_code":"#/components/schemas/CountryCodeFilter","cta":"#/components/schemas/CtaFilter","dataset_id":"#/components/schemas/DatasetIdsFilter","dominant_emotion":"#/components/schemas/DominantEmotionFilter","has_media":"#/components/schemas/HasMediaFilter","hook":"#/components/schemas/HookFilter","keyword":"#/components/schemas/KeywordFilter","mentioned_brands":"#/components/schemas/MentionedBrandsFilter","metric_change":"#/components/schemas/MetricChangeFilter","sentiment":"#/components/schemas/SentimentFilter","source":"#/components/schemas/SourceFilter","tone_of_voice":"#/components/schemas/ToneOfVoiceFilter"}}},"type":"array","minItems":1},"type":"array","minItems":1,"description":"List of filter groups combined with OR. Filters within each group are combined with AND. Maximum 20 filters total."},{"type":"null"}],"title":"Filters"},"collection_ids":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Collection Ids"},"parameter_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":20},{"type":"null"}],"title":"Parameter Ids","description":"Optional list of custom-parameter ids to fetch alongside each mention. IDs not owned by the calling account are silently dropped (the request as a whole still succeeds). When omitted or empty, the response objects do not carry a ``parameters`` field."},"q":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Q"},"search_mode":{"$ref":"#/components/schemas/SearchMode","default":"keyword"}},"type":"object","title":"ListMentionsBody"},"LocationCountryFilter":{"properties":{"type":{"type":"string","const":"location_country","title":"Type","default":"location_country"},"values":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Values","description":"Country names as stored on the profile row (LLM-populated free text, e.g. 'United States'). Multiple values are combined with OR within this filter."}},"type":"object","required":["values"],"title":"LocationCountryFilter"},"Mention":{"properties":{"source":{"$ref":"#/components/schemas/SearchSource"},"id":{"type":"string","title":"Id"},"author":{"$ref":"#/components/schemas/MentionAuthor"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"text":{"type":"string","title":"Text"},"url":{"type":"string","title":"Url"},"media":{"items":{"oneOf":[{"$ref":"#/components/schemas/Image"},{"$ref":"#/components/schemas/Video"}],"discriminator":{"propertyName":"type","mapping":{"image":"#/components/schemas/Image","video":"#/components/schemas/Video"}}},"type":"array","title":"Media"},"num_views":{"type":"integer","title":"Num Views"},"are_views_estimated":{"type":"boolean","title":"Are Views Estimated"},"num_likes":{"type":"integer","title":"Num Likes"},"num_comments":{"type":"integer","title":"Num Comments"},"num_shares":{"type":"integer","title":"Num Shares"},"engagement_rate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Engagement Rate"},"sentiment":{"anyOf":[{"$ref":"#/components/schemas/MentionSentiment"},{"type":"null"}]},"sentiment_score":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentiment Score"},"emotions":{"anyOf":[{"$ref":"#/components/schemas/MentionEmotions"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"content_intention":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Intention"},"tone_of_voice":{"anyOf":[{"$ref":"#/components/schemas/ContentSignal"},{"type":"null"}]},"narrative_structure":{"anyOf":[{"$ref":"#/components/schemas/ContentSignal"},{"type":"null"}]},"hook":{"anyOf":[{"$ref":"#/components/schemas/ContentSignal"},{"type":"null"}]},"cta":{"anyOf":[{"$ref":"#/components/schemas/ContentSignal"},{"type":"null"}]},"content_topics":{"items":{"$ref":"#/components/schemas/ContentSignal"},"type":"array","title":"Content Topics"},"questions":{"items":{"$ref":"#/components/schemas/ContentSignal"},"type":"array","title":"Questions"},"mentioned_brands":{"items":{"type":"string"},"type":"array","title":"Mentioned Brands"},"entities":{"items":{"type":"string"},"type":"array","title":"Entities"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"created_at":{"type":"integer","title":"Created At"},"dataset_run_at":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dataset Run At"},"datasets":{"items":{"$ref":"#/components/schemas/ShortDataset"},"type":"array","title":"Datasets"},"collections":{"items":{"$ref":"#/components/schemas/ShortCollection"},"type":"array","title":"Collections"},"comments":{"anyOf":[{"items":{"$ref":"#/components/schemas/MentionComment"},"type":"array"},{"type":"null"}],"title":"Comments"},"parameters":{"additionalProperties":{"$ref":"#/components/schemas/MentionParameterValue"},"type":"object","title":"Parameters"}},"type":"object","required":["source","id","author","title","text","url","media","num_views","are_views_estimated","num_likes","num_comments","num_shares","engagement_rate","sentiment","emotions","category","content_intention","tone_of_voice","narrative_structure","hook","cta","created_at","datasets"],"title":"Mention"},"MentionAuthor":{"properties":{"avatar":{"anyOf":[{"$ref":"#/components/schemas/Image"},{"type":"null"}]},"title":{"type":"string","title":"Title"},"title_url":{"type":"string","title":"Title Url"},"headline":{"type":"string","title":"Headline"},"headline_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline Url"}},"type":"object","required":["avatar","title","title_url","headline","headline_url"],"title":"MentionAuthor"},"MentionComment":{"properties":{"id":{"type":"string","title":"Id"},"author_username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Username"},"body":{"type":"string","title":"Body"},"num_likes":{"type":"integer","title":"Num Likes"},"num_replies":{"type":"integer","title":"Num Replies"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","author_username","body","num_likes","num_replies","created_at"],"title":"MentionComment","description":"Comment body attached to a mention.\n\nMirrors the shape returned by the private ``get_posts`` endpoint\n(``PostComment`` in ``routes/private/processing/schemas.py``); redeclared\nhere to keep the public-layer ``Mention`` response model free of\nprivate-layer imports (which would form a circular dependency via\n``DatasetSearchQuery``/``DateRange``)."},"MentionEmotions":{"properties":{"neutral":{"type":"string","title":"Neutral"},"joy":{"type":"string","title":"Joy"},"sadness":{"type":"string","title":"Sadness"},"anger":{"type":"string","title":"Anger"},"surprise":{"type":"string","title":"Surprise"},"fear":{"type":"string","title":"Fear"},"disgust":{"type":"string","title":"Disgust"}},"type":"object","required":["neutral","joy","sadness","anger","surprise","fear","disgust"],"title":"MentionEmotions","description":"Per-mention emotion distribution. Null if emotion analysis didn't run."},"MentionParameterValue":{"properties":{"value":{"anyOf":[{},{"type":"null"}],"title":"Value"},"status":{"type":"string","enum":["pending","processing","done","error"],"title":"Status"},"computed_at":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Computed At"}},"type":"object","required":["value","status","computed_at"],"title":"MentionParameterValue","description":"One custom-parameter value attached to a mention.\n\nSurfaced under ``Mention.parameters`` keyed by ``custom_parameter_id``\n(not name -- names can change without invalidating data). ``value`` is\nJSON passthrough (the LLM-produced shape declared by the parameter's\n``value_type``); ``None`` while the row is still pending or errored.\n``computed_at`` is unix-seconds and ``None`` until the row reaches the\nterminal ``done`` state."},"MentionSentiment":{"properties":{"negative":{"type":"string","title":"Negative"},"neutral":{"type":"string","title":"Neutral"},"positive":{"type":"string","title":"Positive"}},"type":"object","required":["negative","neutral","positive"],"title":"MentionSentiment","description":"Per-mention sentiment distribution (sums to 1.0).\n\nNull when sentiment analysis didn't run for this post."},"MentionedBrandsAnyOfOperator":{"properties":{"type":{"type":"string","const":"any_of","title":"Type","default":"any_of"},"values":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Values"}},"type":"object","required":["values"],"title":"MentionedBrandsAnyOfOperator"},"MentionedBrandsContainsOperator":{"properties":{"type":{"type":"string","const":"contains","title":"Type","default":"contains"},"value":{"type":"string","minLength":1,"title":"Value"}},"type":"object","required":["value"],"title":"MentionedBrandsContainsOperator"},"MentionedBrandsEqualsOperator":{"properties":{"type":{"type":"string","const":"equals","title":"Type","default":"equals"},"value":{"type":"string","minLength":1,"title":"Value"}},"type":"object","required":["value"],"title":"MentionedBrandsEqualsOperator"},"MentionedBrandsFilter":{"properties":{"type":{"type":"string","const":"mentioned_brands","title":"Type","default":"mentioned_brands"},"operator":{"oneOf":[{"$ref":"#/components/schemas/MentionedBrandsAnyOfOperator"},{"$ref":"#/components/schemas/MentionedBrandsEqualsOperator"},{"$ref":"#/components/schemas/MentionedBrandsContainsOperator"}],"title":"Operator","discriminator":{"propertyName":"type","mapping":{"any_of":"#/components/schemas/MentionedBrandsAnyOfOperator","contains":"#/components/schemas/MentionedBrandsContainsOperator","equals":"#/components/schemas/MentionedBrandsEqualsOperator"}}}},"type":"object","required":["operator"],"title":"MentionedBrandsFilter"},"MentionsOperation":{"type":"string","enum":["select","count"],"title":"MentionsOperation","description":"Switch on the ``POST /mentions`` family. ``select`` (the default)\nreturns the existing paginated mentions response; ``count`` returns\n``{count: int}`` skipping pagination/hydration. Same body shape,\nsame filter compilation; pagination params (cursor, limit) are\nignored when ``operation=count``."},"MentionsSortType":{"type":"string","enum":["date","likes","engagement_rate","views","comments","shares","sentiment_score","dataset_run_at"],"title":"MentionsSortType"},"MetricChangeFilter":{"properties":{"type":{"type":"string","const":"metric_change","title":"Type","default":"metric_change"},"metric":{"$ref":"#/components/schemas/MetricType"},"operator":{"oneOf":[{"$ref":"#/components/schemas/MetricGreaterThanOperator"},{"$ref":"#/components/schemas/MetricLessThanOperator"},{"$ref":"#/components/schemas/MetricInRangeOperator"},{"$ref":"#/components/schemas/MetricChangedByOperator"}],"title":"Operator","discriminator":{"propertyName":"type","mapping":{"changed_by":"#/components/schemas/MetricChangedByOperator","greater_than":"#/components/schemas/MetricGreaterThanOperator","in_range":"#/components/schemas/MetricInRangeOperator","less_than":"#/components/schemas/MetricLessThanOperator"}}}},"type":"object","required":["metric","operator"],"title":"MetricChangeFilter"},"MetricChangedByOperator":{"properties":{"type":{"type":"string","const":"changed_by","title":"Type","default":"changed_by"},"threshold_pct":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"string"}],"title":"Threshold Pct"},"comparison_period":{"$ref":"#/components/schemas/ComparisonPeriod"}},"type":"object","required":["threshold_pct","comparison_period"],"title":"MetricChangedByOperator"},"MetricGreaterThanOperator":{"properties":{"type":{"type":"string","const":"greater_than","title":"Type","default":"greater_than"},"value":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string"}],"title":"Value"}},"type":"object","required":["value"],"title":"MetricGreaterThanOperator"},"MetricInRangeOperator":{"properties":{"type":{"type":"string","const":"in_range","title":"Type","default":"in_range"},"min_value":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string"}],"title":"Min Value"},"max_value":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string"}],"title":"Max Value"}},"type":"object","required":["min_value","max_value"],"title":"MetricInRangeOperator"},"MetricLessThanOperator":{"properties":{"type":{"type":"string","const":"less_than","title":"Type","default":"less_than"},"value":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string"}],"title":"Value"}},"type":"object","required":["value"],"title":"MetricLessThanOperator"},"MetricType":{"type":"string","enum":["likes","views","comments","engagement_rate"],"title":"MetricType"},"PromptDatasetSearchQuery":{"properties":{"type":{"type":"string","const":"prompt","title":"Type"},"sources":{"items":{"$ref":"#/components/schemas/SearchSource"},"type":"array","minItems":1,"title":"Sources"},"search_query":{"type":"string","maxLength":5000,"minLength":1,"title":"Search Query"},"fragments":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":5},{"type":"null"}],"title":"Fragments"}},"type":"object","required":["type","sources","search_query"],"title":"PromptDatasetSearchQuery"},"RangeGreaterThanOperator":{"properties":{"type":{"type":"string","const":"greater_than","title":"Type","default":"greater_than"},"value":{"anyOf":[{"type":"number"},{"type":"string"}],"title":"Value"}},"type":"object","required":["value"],"title":"RangeGreaterThanOperator"},"RangeInRangeOperator":{"properties":{"type":{"type":"string","const":"in_range","title":"Type","default":"in_range"},"min_value":{"anyOf":[{"type":"number"},{"type":"string"}],"title":"Min Value"},"max_value":{"anyOf":[{"type":"number"},{"type":"string"}],"title":"Max Value"}},"type":"object","required":["min_value","max_value"],"title":"RangeInRangeOperator"},"RangeLessThanOperator":{"properties":{"type":{"type":"string","const":"less_than","title":"Type","default":"less_than"},"value":{"anyOf":[{"type":"number"},{"type":"string"}],"title":"Value"}},"type":"object","required":["value"],"title":"RangeLessThanOperator"},"ResponseSchema_AudienceDatasetResponse_":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType"},"data":{"$ref":"#/components/schemas/AudienceDatasetResponse"}},"type":"object","required":["status","data"],"title":"ResponseSchema[AudienceDatasetResponse]"},"ResponseSchema_AudienceDatasetRunResponse_":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType"},"data":{"$ref":"#/components/schemas/AudienceDatasetRunResponse"}},"type":"object","required":["status","data"],"title":"ResponseSchema[AudienceDatasetRunResponse]"},"ResponseSchema_CreateAudienceDatasetResponse_":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType"},"data":{"$ref":"#/components/schemas/CreateAudienceDatasetResponse"}},"type":"object","required":["status","data"],"title":"ResponseSchema[CreateAudienceDatasetResponse]"},"ResponseSchema_CreateAudienceDatasetRunResponse_":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType"},"data":{"$ref":"#/components/schemas/CreateAudienceDatasetRunResponse"}},"type":"object","required":["status","data"],"title":"ResponseSchema[CreateAudienceDatasetRunResponse]"},"ResponseSchema_CreateDatasetResponse_":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType"},"data":{"$ref":"#/components/schemas/CreateDatasetResponse"}},"type":"object","required":["status","data"],"title":"ResponseSchema[CreateDatasetResponse]"},"ResponseSchema_CreateDatasetRunResponse_":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType"},"data":{"$ref":"#/components/schemas/CreateDatasetRunResponse"}},"type":"object","required":["status","data"],"title":"ResponseSchema[CreateDatasetRunResponse]"},"ResponseSchema_DatasetResponse_":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType"},"data":{"$ref":"#/components/schemas/DatasetResponse"}},"type":"object","required":["status","data"],"title":"ResponseSchema[DatasetResponse]"},"ResponseSchema_DatasetRunResponse_":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType"},"data":{"$ref":"#/components/schemas/DatasetRunResponse"}},"type":"object","required":["status","data"],"title":"ResponseSchema[DatasetRunResponse]"},"ResponseStatusType":{"type":"string","enum":["info","success","redirect","client_error","server_error"],"title":"ResponseStatusType"},"RunStatusEnvelope":{"properties":{"type":{"$ref":"#/components/schemas/RunStatusType"},"steps":{"items":{"anyOf":[{"$ref":"#/components/schemas/CompletedStep"},{"$ref":"#/components/schemas/FailedStep"}]},"type":"array","title":"Steps"}},"type":"object","required":["type"],"title":"RunStatusEnvelope"},"RunStatusType":{"type":"string","enum":["pending","working","completed","failed"],"title":"RunStatusType"},"SearchMode":{"type":"string","enum":["keyword","semantic"],"title":"SearchMode"},"SearchSource":{"type":"string","enum":["reddit","tiktok","youtube","x","instagram","linkedin"],"title":"SearchSource"},"SentimentFilter":{"properties":{"type":{"type":"string","const":"sentiment","title":"Type","default":"sentiment"},"values":{"items":{"$ref":"#/components/schemas/SentimentFilterValue"},"type":"array","minItems":1,"title":"Values"}},"type":"object","required":["values"],"title":"SentimentFilter"},"SentimentFilterValue":{"type":"string","enum":["positive","negative","neutral"],"title":"SentimentFilterValue"},"ShortCollection":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"}},"type":"object","required":["id","name"],"title":"ShortCollection"},"ShortDataset":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"}},"type":"object","required":["id","name"],"title":"ShortDataset"},"SourceFilter":{"properties":{"type":{"type":"string","const":"source","title":"Type","default":"source"},"values":{"items":{"$ref":"#/components/schemas/SearchSource"},"type":"array","minItems":1,"title":"Values"}},"type":"object","required":["values"],"title":"SourceFilter"},"ToneOfVoiceFilter":{"properties":{"type":{"type":"string","const":"tone_of_voice","title":"Type","default":"tone_of_voice"},"operator":{"type":"string","const":"any_of","title":"Operator","default":"any_of"},"values":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Values"}},"type":"object","required":["values"],"title":"ToneOfVoiceFilter"},"URLDatasetSearchQuery-Input":{"properties":{"type":{"type":"string","const":"url","title":"Type"},"source_urls":{"items":{"$ref":"#/components/schemas/DatasetSourceURL"},"type":"array","maxItems":100,"minItems":1,"title":"Source Urls"}},"type":"object","required":["type","source_urls"],"title":"URLDatasetSearchQuery"},"URLDatasetSearchQuery-Output":{"properties":{"type":{"type":"string","const":"url","title":"Type"},"source_urls":{"items":{"$ref":"#/components/schemas/DatasetSourceURL"},"type":"array","maxItems":100,"minItems":1,"title":"Source Urls"}},"type":"object","required":["type","source_urls"],"title":"URLDatasetSearchQuery"},"UpdateAudienceDatasetBody":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Name"}},"type":"object","title":"UpdateAudienceDatasetBody"},"UpdateDatasetBody":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Name"}},"type":"object","title":"UpdateDatasetBody"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"Video":{"properties":{"type":{"type":"string","const":"video","title":"Type","default":"video"},"version_list":{"items":{"$ref":"#/components/schemas/VideoVersion"},"type":"array","title":"Version List"},"cover_image":{"$ref":"#/components/schemas/VideoCoverImage"},"description":{"type":"string","title":"Description","default":""},"transcription":{"type":"string","title":"Transcription","default":""}},"type":"object","required":["version_list","cover_image"],"title":"Video"},"VideoCoverImage":{"properties":{"version_list":{"items":{"$ref":"#/components/schemas/ImageVersion"},"type":"array","title":"Version List"}},"type":"object","required":["version_list"],"title":"VideoCoverImage"},"VideoVersion":{"properties":{"url":{"type":"string","title":"Url"},"width":{"type":"integer","title":"Width"},"height":{"type":"integer","title":"Height"},"bit_rate":{"type":"integer","title":"Bit Rate"},"duration_millis":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Millis"}},"type":"object","required":["url","width","height","bit_rate","duration_millis"],"title":"VideoVersion"},"api__routes__common__responses__schemas____1":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"dataset_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____10":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"too_many_target_urls"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____11":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"text_search_unavailable"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____12":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"dataset_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____13":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"dataset_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____14":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"dataset_run_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____15":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"audience_research_unavailable"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____16":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"audience_dataset_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____17":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"audience_dataset_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____18":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"audience_dataset_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____19":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"audience_research_unavailable"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____2":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"dataset_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____20":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"source_dataset_has_no_completed_run"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____21":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"insufficient_credits_audience_dataset_run"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____22":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"audience_dataset_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____23":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"dataset_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____24":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"audience_dataset_run_already_in_flight"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____25":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"audience_dataset_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____26":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"audience_dataset_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____27":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"audience_dataset_run_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____28":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"dataset_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____29":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"audience_dataset_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____3":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"dataset_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____4":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"insufficient_credits_dataset_run"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____5":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"dataset_not_found"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____6":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"date_filter_unavailable"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____7":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"unsupported_search_type"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____8":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"invalid_scraping_target_url"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""},"api__routes__common__responses__schemas____9":{"properties":{"status":{"$ref":"#/components/schemas/ResponseStatusType","default":"client_error"},"error_code":{"type":"string","title":"Error Code","default":"duplicate_target_url"},"detail":{"type":"string","title":"Detail"},"transient":{"type":"boolean","title":"Transient"}},"type":"object","required":["detail","transient"],"title":""}}}}