# YouScan, contact us: News API

> Integrate social media listening data into your own tools. Manage topics, retrieve mentions, and query statistics through the YouScan API.

YouScan's news API on its Unlimited plan. It returns 5 of the 6 key fields we check: Source, Date, Author, Image, Full text.
We haven't run YouScan through [our news API benchmark](https://datacircle.dev/best-news-api.txt) yet.
YouScan gives this plan's price on request. We rank 710 plans for news APIs by price. Half the plans cost $1.00 per 1,000 searches or less.
[Financial Data (financialdata.net)'s $69 monthly plan](https://datacircle.dev/news-apis/financial-data-financialdata-net/69-monthly-premium-get-api-v1-latest-news/llms.txt) is the cheapest paid plan per 1,000 searches: as little as $0.00089. Financial Data (financialdata.net)'s $69 monthly plan covers up to 77,760,000 searches a month at no extra cost.
[Finage's $49 monthly plan (/news/cryptocurrency/{symbol})](https://datacircle.dev/news-apis/finage/49-monthly-simple-plan-get-news-cryptocurrency-symbol/llms.txt) covers any number of searches. Finage's $49 monthly plan costs less up front than Financial Data (financialdata.net)'s $69 monthly plan.
[The New York Times](https://datacircle.dev/news-apis/the-new-york-times/free/llms.txt), [Scrappa](https://datacircle.dev/news-apis/scrappa/25-pack/llms.txt) and [SerpScraper.dev](https://datacircle.dev/news-apis/serpscraper-dev/39-monthly/llms.txt) are the best news API providers in the Datacircle benchmark.

- This page: https://datacircle.dev/news-apis/youscan/contact-us
- [News API: 60+ providers compared on price and data](https://datacircle.dev/best-news-api.txt)
- Get it: https://youscan.io/pricing/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=news-api-pricing
- Request: `GET https://api.youscan.io/api/external/topics/{topicId}/mentions`
- API key: with the plan, on https://youscan.io/pricing/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=news-api-pricing
- Its API docs: https://developers.youscan.io/api/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=news-api-pricing#tag/mentions/GET/topics/{topicId}/mentions
- Sold by: YouScan (https://youscan.io?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=news-api-pricing)
- Checked: 2026-11-04

## In the answer

- Completeness: 83%
- Source: ✓
- Date: ✓
- Author: ✓
- Image: ✓
- Full text: ✓

## Price

- Billing: contact

## Charges

- Most per search: no limit
- Also pays for: List topics · Create topic · Preview topic · Update topic query · Delete topic · History collection details · Start history collection · Stop history collection · List tags · Create tag · List spaces · List categories · Sentiment · Tags · Word cloud · Countries · Cities · Sentiment by regions · Sentiment by sources · Sentiment by sources by regions · Histogram · Genders · Ages · Links · Engagement metrics · Get mentions by IDs · Get mentions by IDs (POST) · Bulk update mentions · Create import · List imports · Get import status · Abort import · Get import errors

## In their words

- Their pitch: Integrate social media listening data into your own tools. Manage topics, retrieve mentions, and query statistics through the YouScan API.

## Data

- Keep data: no limit
- Use data: "The Client may purchase limited licenses to access and use the API. [...] YouScan grants the Client a non-exclusive, non-transferable, non-assignable, worldwide limited license to access and use the API solely for the Client’s internal business purposes and only during the Term specified in the applicable fully executed Order Form.", "\"Permitted Purpose\" of access to data under this Agreement shall be limited to the following: [...] The creation by the Client, through Data Analysis, of commercially valuable information concerning brand image [...] and [...] of commercially valuable information (\"Deliverables\"), which may be used by the Client for its legitimate business purposes.", "The Client is prohibited from the following activities: [...] Misuse of the API. Using the Company’s API in any manner not expressly authorized by the Company, including accessing it to create similar or competitive products or services [...]", "Restricted Use of API and Data Transmission. Using the API, Webhooks, or Company’s standard connectors for large-scale or automated data transfers to external services or platforms, except as expressly authorized by the applicable Order Form or the agreed functionality of the relevant feature [...]", "Public Reference to Data Origin. Publicly referencing the data obtained through the Service without prior written consent from the Company.", "Prohibited Commercial Activities. Assigning, renting, selling, leasing, transferring, distributing, or making the Service available to any Third-Party [...]", "The Client shall not use, and shall not permit any third party to use, any data, content, materials, exports, API outputs, reports, metadata, media links, public data, or other information obtained from or through the YouScan Services for the purpose of training, fine-tuning, developing, improving, benchmarking, validating, or creating any artificial intelligence, machine learning, large language model, foundation model, data model, algorithm, classifier, or similar automated system, unless YouScan has expressly approved such use in writing. [...] The Client may not use YouScan-provided data to build or improve a standalone dataset, model-training corpus, synthetic dataset, data product, analytics product, or competing service."

## Rate limit

- Per second: 1
- Concurrent: 5
- Batch: 1

## Speed

- Answer: in the call

## The call

- You send: topicId. Optional: from, to, addedFrom, addedTo, sinceSeq, sentiment, excludeSentiment, engagementFrom, engagementTo, engagementCollectedFrom, engagementCollectedTo, sources, excludeSources, sourceTypes, excludeSourceTypes, postTypes, excludePostTypes, tags, excludeTags, autoCategories, excludeAutoCategories, starred, tagged, processed, deleted, spam, textQuery, dedup, htmlSanitize, timeZone, size, skip, orderBy
- Method: GET
- Path: /topics/{topicId}/mentions

## About the plan

- Plan: Unlimited
- Who can get it: a Client with a signed Order Form, the platform is authorized for use solely within the jurisdiction of the country where the Client is legally registered

## The 90 fields the plan's answer can hold

total results, last sequence number, mention ID, sequence number, published date, added date, URL, title, text, full text, image URL, images, source, author profile ID, author URL, author name, author nickname, author bio, author avatar URL, author subscribers, author gender, author age, author jobs, author interests, author interest categories, publication place profile ID, publication place URL, publication place name, publication place nickname, publication place bio, publication place avatar URL, publication place subscribers, publication place gender, publication place age, publication place jobs, publication place interests, publication place interest categories, sentiment, source type, resource type, language, image activities, image brands, image colors, image objects, image people, image scenes, image texts, post type, content types, collection methods, source format, tags, rating, auto categories, subjects, starred, processed, likes, dislikes, comments, reposts, views, reach, saves, impressions, engagement, reactions, angry reactions, haha reactions, love reactions, sad reactions, wow reactions, care reactions, engagement collected date, post ID, parent post ID, discussion ID, country, region, city, note, aspects, sentiment aspects, potential reach, custom tags, categories, speech language, speech segments, speech timecode URL template

## YouScan's plans (1)

- [YouScan, contact us](https://datacircle.dev/news-apis/youscan/contact-us/llms.txt): 83% complete

## YouScan's calls (1)

- `GET /topics/{topicId}/mentions`: [YouScan, contact us](https://datacircle.dev/news-apis/youscan/contact-us/llms.txt)

## YouScan's APIs (1)

- [YouScan: news API pricing, 1 plan](https://datacircle.dev/news-apis/youscan/contact-us/llms.txt)

## YouScan: news API alternatives

- [PrismCrawl, contact us, Custom, POST /v1/google/news](https://datacircle.dev/news-apis/prismcrawl/contact-us-custom-post-v1-google-news/llms.txt): 83% complete, live
- [GNews, contact us, Create Your Own Plan, GET /api/v4/search](https://datacircle.dev/news-apis/gnews/contact-us-create-your-own-plan-get-api-v4-search/llms.txt): 83% complete, stored
- [NewsAPI.org, contact us, Enterprise, GET /v2/everything](https://datacircle.dev/news-apis/newsapi-org/contact-us-enterprise-get-v2-everything/llms.txt): 83% complete, live
- [NewsAPI.ai (Event Registry), contact us](https://datacircle.dev/news-apis/newsapi-ai-event-registry/contact-us/llms.txt): 83% complete
- [NewsWhip, contact us](https://datacircle.dev/news-apis/newswhip/contact-us/llms.txt): 83% complete

## Sources

From each provider's own pricing page and docs, and from what providers tell us. We read this row from these pages on 2026-11-04.

- https://developers.youscan.io/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=news-api-pricing
- https://developers.youscan.io/api/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=news-api-pricing
- https://developers.youscan.io/api/openapi.yaml?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=news-api-pricing
- https://help.youscan.io/en/articles/2754452-how-to-use-the-youscan-api?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=news-api-pricing
- https://youscan.io/pricing/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=news-api-pricing
- https://youscan.io/terms-of-service/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=news-api-pricing