Toutiao

aid: toutiao
name: Toutiao
description: 'Toutiao (今日头条) is ByteDance''s AI-driven content recommendation platform, launched in 2012, aggregating news,
  articles, short video and micro-posts into a personalized feed for hundreds of millions of readers in China. Creators publish
  through 头条号 (Toutiao Hao) accounts on mp.toutiao.com, and third-party developers integrate through the ByteDance open-platform
  stack: Toutiao account OAuth 2.0 and user-profile APIs served from open.snssdk.com and documented on the Douyin Open Platform
  under the toutiao-or-xigua section, a content-sync and video publishing surface available to approved applications, mini-programs
  via the ByteDance mini-app developer platform, and advertising APIs that have since migrated from ad.toutiao.com to OceanEngine
  (巨量引擎). Toutiao publishes no OpenAPI, AsyncAPI, llms.txt or A2A agent card; its developer program is registration- and approval-gated
  and its documentation is client-side rendered in Chinese.'
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: false
  label: Hosted service · you call their endpoint
  confidence: medium
  source:
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  gated: none
  gated_source:
  - onboarding
  label: Self-serve signup
  confidence: medium
  probe_state: unreadable
  source:
  - authentication
  - scopes
  - security
  generated: '2026-11-06'
  method: derived
image: https://sf3-cdn-tos.douyinstatic.com/obj/eden-cn/uhbfnupkbps/toutiao_favicon.ico
url: https://raw.githubusercontent.com/api-evangelist/toutiao/refs/heads/main/apis.yml
x-type: company
x-source: harvest:secondary-market
specificationVersion: '0.23'
created: '2026-08-05'
modified: '2026-08-05'
tags:
- Company
- News
- Content
- Media
- Social
- Recommendations
- Publishing
- ByteDance
- China
- OAuth
- Authentication
tags_raw:
- Company
- News
- Content
- Media
- Social
- Recommendation
- Publishing
- ByteDance
- China
- OAuth
- Authentication
apis:
- name: Toutiao Open API (OAuth + User Profile)
  description: Toutiao account OAuth 2.0 and user-profile API, served from the open.snssdk.com host and documented on the
    Douyin Open Platform under the toutiao-or-xigua permission section. Supports the authorization-code flow (authorize, access_token,
    refresh_token, renew_refresh_token) and returns the authorized user's open_id, nickname and avatar; the mobile_alert permission
    additionally returns an AES-encrypted phone number. Scopes are namespaced toutiao.* and are granted per-application in
    the open-platform console. Access tokens are valid 15 days, refresh tokens 30 days. No OpenAPI is published for this surface.
  humanURL: https://open.douyin.com/platform/resource/docs/develop/permission/toutiao-or-xigua/OAuth2.0/
  baseURL: https://open.snssdk.com
  tags:
  - OAuth
  - Authentication
  - Identity
  tags_raw:
  - OAuth
  - Authentication
  - Identity
  properties:
  - type: Documentation
    url: https://open.douyin.com/platform/resource/docs/develop/permission/toutiao-or-xigua/OAuth2.0/
  - type: Authentication
    url: authentication/toutiao-authentication.yml
  - type: OAuthScopes
    url: scopes/toutiao-scopes.yml
  - type: ErrorCatalog
    url: errors/toutiao-problem-types.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: DomainSecurity
  url: security/toutiao-domain-security.yml
- type: Website
  url: https://www.toutiao.com/
- type: DeveloperPortal
  url: https://open.toutiao.com/
- type: Documentation
  url: https://open.douyin.com/platform/resource/docs/develop/permission/toutiao-or-xigua/OAuth2.0/
- type: APIReference
  url: https://open.douyin.com/platform/resource/docs/ability/content-management/toutiao-publish-solution/
- type: SignUp
  url: https://mp.toutiao.com/auth/page/login
- type: TermsOfService
  url: https://www.toutiao.com/user_agreement/
- type: PrivacyPolicy
  url: https://www.toutiao.com/privacy_protection/
- type: Authentication
  url: authentication/toutiao-authentication.yml
- type: OAuthScopes
  url: scopes/toutiao-scopes.yml
- type: ErrorCatalog
  url: errors/toutiao-problem-types.yml
- type: Conventions
  url: conventions/toutiao-conventions.yml
- type: Lifecycle
  url: lifecycle/toutiao-lifecycle.yml
- type: Conformance
  url: conformance/toutiao-conformance.yml
- type: Packages
  url: packages/toutiao-packages.yml
- type: LLMsTxt
  url: llms/toutiao-llms.txt
- type: SecondaryMarket
  url: https://forgeglobal.com/toutiao_stock/
x-enrichment:
  date: '2026-08-05'
  status: minimal
  artifacts_added: 10
  pass: local-v1
x-coverage:
  state: unreadable
  reason: no-machine-readable-spec
  detail: ByteDance documents the Toutiao OAuth and user-profile API publicly on the Douyin Open Platform and the endpoints
    answer live on open.snssdk.com, but no OpenAPI, AsyncAPI, GraphQL SDL, Postman collection or JSON Schema is published
    on any Toutiao, snssdk or ByteDance host — and open.douyin.com returns a 200 HTML single-page-app shell for /openapi.json
    and every /.well-known/ path, byte-identical to a nonexistent control path, so there is nothing for a machine to fetch.
  evidence:
  - url: https://open.snssdk.com/oauth/access_token/
    status: 200
  - url: https://open.snssdk.com/openapi.json
    status: 404
  - url: https://open.douyin.com/platform/resource/docs/develop/permission/toutiao-or-xigua/OAuth2.0/
    status: 200
  - url: https://open.douyin.com/openapi.json
    status: 200
  - url: https://www.toutiao.com/.well-known/agent-card.json
    status: 404
  checked: '2026-08-05'