# YouScan Topics API

**Canonical:** https://apis.io/apis/youscan/youscan-topics-api/  
**Provider:** YouScan — https://apis.io/providers/youscan/  
**Base URL:** https://api.youscan.io/api/external  
**Documentation:** https://developers.youscan.io/

YouScan Topics API is one of 8 APIs that [YouScan](https://apis.io/providers/youscan/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Topics. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Create and manage topics — the monitoring entities that collect mentions matching your queries. ### Topic query structure A topic query consists of a `textQuery` and/or `viQuery` (at least one is required) plus an optional `filter`. For all topic query filters, the following field names are supported: - `country`: ISO2 country code (e.g. `country=US`, `country=UA`) - `countryGroup`: Europe, Asia, NorthAmerica, CentralAmerica, TheCaribbean, SouthAmerica, Africa, Oceania (e.g. `countryGroup=Europe`) - `language`: ISO639-2 language code (e.g. `language=ENG`, `language=UKR`) - `source`: domain format (e.g. `source=instagram.com`) - `sourceType`: social, messenger, reviews, news, blog, forum (e.g. `sourceType=social`) - `postType`: post, repost, extendedRepost, comment (e.g. `postType=post`) - `contentType`: text, link, image, video, poll, subtitles, sticker (e.g. `contentType=image`) - `authorAge`: numeric value (e.g. `authorAge=18`) - `authorSubscribers`: numeric value (e.g. `authorSubscribers=1000`) - `gender`: `male` or `female` (e.g. `gender=male`) Supported Visual Insights (VI) query values (used inside `viQuery`): - `logo`: detect specific brand logos (e.g. `logo:"nike"`) - `image.object`: find specific objects (e.g. `image.object:"car"`) - `image.activity`: find activities (e.g. `image.activity:"cooking"`) - `image.person`: find people types (e.g. `image.person:"athlete"`) - `image.scene`: find settings (e.g. `image.scene:"beach"`) - `image.type`: filter by image type (e.g. `image.type:"PHOTO"`) - `image.subtype`: filter by image subtype (e.g. `image.subtype:"selfie"`) - `text`: search mention text (e.g. `text:"sale"`) Supported operations for each filter: - `oneOf`: field value must match one of the specified values. Applicable to most fields. - `notOneOf`: field value must not match any of the specified values. Applicable to most fields. - `greaterOrEqual`: field value must be greater than or equal to the specified value. Numeric fields only (`authorAge`, `authorSubscribers`). - `lessOrEqual`: field value must be less than or equal to the specified value. Numeric fields only (`authorAge`, `authorSubscribers`). Each filter object must specify: - `fieldName`: The field to filter on (see the list above) - `op`: The operation to perform (see the list above) - `value`: JSON-encoded array of values (e.g. `["ua"]`)

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/youscan/refs/heads/main/openapi/youscan-topics-api-openapi.yml
- **LLMsTxt** — https://raw.githubusercontent.com/api-evangelist/youscan/refs/heads/main/llms/youscan-llms.txt
- **Documentation** — https://developers.youscan.io/
- **APIReference** — https://developers.youscan.io/api/

## Other YouScan APIs (7)

- [YouScan Data Import API](https://apis.io/apis/youscan/youscan-data-import-api/)
- [YouScan History API](https://apis.io/apis/youscan/youscan-history-api/)
- [YouScan Mentions API](https://apis.io/apis/youscan/youscan-mentions-api/)
- [YouScan Spaces API](https://apis.io/apis/youscan/youscan-spaces-api/)
- [YouScan Statistics API](https://apis.io/apis/youscan/youscan-statistics-api/)
- [YouScan Tags API](https://apis.io/apis/youscan/youscan-tags-api/)
- [YouScan Webhook API](https://apis.io/apis/youscan/youscan-webhook-api/)

## Tags

Topics

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/youscan/youscan-topics-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/youscan/.