> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anysite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# /kyodo/articles

> Get one Kyodo News article by id or url: headline, meta description, body text, publish and last-modified timestamps, writer byline, the wire or partner that supplied it, the categories it is filed under, every header photo with its caption, embedded podcast and video players, and the related-coverage links. Available in the English, simplified Chinese and traditional Chinese editions, each of which numbers its articles separately. Kyodo's own copy carries the full body only for the first days after publication — body_access and is_body_truncated say which part of the text the response holds.

**Price:** 1 credit

**⚠️ Common errors:** 412: No article with this id in the requested edition



## OpenAPI

````yaml /openapi/news-publishing.json post /api/kyodo/articles
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/kyodo/articles:
    post:
      tags:
        - /kyodo
      summary: /kyodo/articles
      description: >-
        Get one Kyodo News article by id or url: headline, meta description,
        body text, publish and last-modified timestamps, writer byline, the wire
        or partner that supplied it, the categories it is filed under, every
        header photo with its caption, embedded podcast and video players, and
        the related-coverage links. Available in the English, simplified Chinese
        and traditional Chinese editions, each of which numbers its articles
        separately. Kyodo's own copy carries the full body only for the first
        days after publication — body_access and is_body_truncated say which
        part of the text the response holds.


        **Price:** 1 credit


        **⚠️ Common errors:** 412: No article with this id in the requested
        edition
      operationId: __api_kyodo_articles_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/KyodoArticlesPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/KyodoArticle'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    KyodoArticlesPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        article:
          type: string
          minLength: 1
        edition:
          $ref: '#/components/schemas/KyodoEdition'
          default: en
      type: object
      required:
        - article
    KyodoArticle:
      properties:
        '@type':
          type: string
          default: KyodoArticle
        id:
          type: string
        edition:
          type: string
        article_title:
          type: string
        text:
          anyOf:
            - type: string
            - type: 'null'
        web_url:
          type: string
        language:
          anyOf:
            - type: string
            - type: 'null'
        published_at:
          anyOf:
            - type: integer
            - type: 'null'
        updated_at:
          anyOf:
            - type: integer
            - type: 'null'
        author:
          anyOf:
            - type: string
            - type: 'null'
        source:
          anyOf:
            - type: string
            - type: 'null'
        source_id:
          anyOf:
            - type: string
            - type: 'null'
        source_url:
          anyOf:
            - type: string
            - type: 'null'
        source_image:
          anyOf:
            - type: string
            - type: 'null'
        categories:
          items:
            $ref: '#/components/schemas/KyodoArticleCategory'
          type: array
          default: []
        image:
          anyOf:
            - type: string
            - type: 'null'
        image_width:
          anyOf:
            - type: integer
            - type: 'null'
        image_height:
          anyOf:
            - type: integer
            - type: 'null'
        images:
          items:
            $ref: '#/components/schemas/KyodoArticleImage'
          type: array
          default: []
        embed_urls:
          items:
            type: string
          type: array
          default: []
        related:
          items:
            $ref: '#/components/schemas/KyodoRelatedArticle'
          type: array
          default: []
        body_access:
          type: string
        is_body_truncated:
          type: boolean
        is_accessible_for_free:
          anyOf:
            - type: boolean
            - type: 'null'
        paragraph_count:
          type: integer
      type: object
      required:
        - id
        - edition
        - article_title
        - web_url
        - body_access
        - is_body_truncated
        - paragraph_count
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    KyodoEdition:
      type: string
      enum:
        - en
        - zh-cn
        - zh-tw
    KyodoArticleCategory:
      properties:
        '@type':
          type: string
          default: KyodoArticleCategory
        id:
          type: string
        name:
          type: string
        web_url:
          type: string
      type: object
      required:
        - id
        - name
        - web_url
    KyodoArticleImage:
      properties:
        '@type':
          type: string
          default: KyodoArticleImage
        image:
          type: string
        caption:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - image
    KyodoRelatedArticle:
      properties:
        '@type':
          type: string
          default: KyodoRelatedArticle
        id:
          type: string
        article_title:
          type: string
        web_url:
          type: string
      type: object
      required:
        - id
        - article_title
        - web_url
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````