> ## 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.

# /costar/articles

> Get a single CoStar News article by id or URL. Returns the headline, summary, publication time, lead image with caption, bylined authors, category taxonomy and the article text. The most valuable part is the entity linkage CoStar attaches to each story: the commercial properties (name and street address), companies (name and industry), people (name, job title, company) and investment funds the article is about. Note that for most stories text carries the opening paragraph only — is_full_text tells you whether the complete body was published openly.

**Price:** 10 credits

**⚠️ Common errors:** 412: Article not found



## OpenAPI

````yaml /openapi/news-publishing.json post /api/costar/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/costar/articles:
    post:
      tags:
        - /costar
      summary: /costar/articles
      description: >-
        Get a single CoStar News article by id or URL. Returns the headline,
        summary, publication time, lead image with caption, bylined authors,
        category taxonomy and the article text. The most valuable part is the
        entity linkage CoStar attaches to each story: the commercial properties
        (name and street address), companies (name and industry), people (name,
        job title, company) and investment funds the article is about. Note that
        for most stories text carries the opening paragraph only — is_full_text
        tells you whether the complete body was published openly.


        **Price:** 10 credits


        **⚠️ Common errors:** 412: Article not found
      operationId: __api_costar_articles_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CostarArticlesPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CostarArticle'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    CostarArticlesPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        article:
          type: string
          minLength: 1
      type: object
      required:
        - article
    CostarArticle:
      properties:
        '@type':
          type: string
          default: CostarArticle
        id:
          type: string
        alias:
          anyOf:
            - type: string
            - type: 'null'
        url:
          type: string
        article_title:
          anyOf:
            - type: string
            - type: 'null'
        summary:
          anyOf:
            - type: string
            - type: 'null'
        text:
          anyOf:
            - type: string
            - type: 'null'
        is_full_text:
          type: boolean
          default: false
        published_at:
          anyOf:
            - type: integer
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
        image_caption:
          anyOf:
            - type: string
            - type: 'null'
        badge:
          anyOf:
            - type: string
            - type: 'null'
        template_type:
          anyOf:
            - type: string
            - type: 'null'
        source_locale:
          anyOf:
            - type: string
            - type: 'null'
        translation_type:
          anyOf:
            - type: string
            - type: 'null'
        countries:
          items:
            type: string
          type: array
          default: []
        authors:
          items:
            $ref: '#/components/schemas/CostarArticleAuthor'
          type: array
          default: []
        categories:
          items:
            $ref: '#/components/schemas/CostarArticleCategory'
          type: array
          default: []
        primary_category:
          anyOf:
            - $ref: '#/components/schemas/CostarArticleCategory'
            - type: 'null'
        properties:
          items:
            $ref: '#/components/schemas/CostarArticleProperty'
          type: array
          default: []
        companies:
          items:
            $ref: '#/components/schemas/CostarArticleCompany'
          type: array
          default: []
        contacts:
          items:
            $ref: '#/components/schemas/CostarArticleContact'
          type: array
          default: []
        funds:
          items:
            $ref: '#/components/schemas/CostarArticleFund'
          type: array
          default: []
        related_articles:
          items:
            $ref: '#/components/schemas/CostarRelatedArticle'
          type: array
          default: []
      type: object
      required:
        - id
        - url
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    CostarArticleAuthor:
      properties:
        '@type':
          type: string
          default: CostarArticleAuthor
        id:
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
        alias:
          anyOf:
            - type: string
            - type: 'null'
        affiliation:
          anyOf:
            - type: string
            - type: 'null'
        profile_url:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - id
    CostarArticleCategory:
      properties:
        '@type':
          type: string
          default: CostarArticleCategory
        id:
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
        category_type:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - id
    CostarArticleProperty:
      properties:
        '@type':
          type: string
          default: CostarArticleProperty
        id:
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
        address:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - id
    CostarArticleCompany:
      properties:
        '@type':
          type: string
          default: CostarArticleCompany
        key:
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
        industry:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - key
    CostarArticleContact:
      properties:
        '@type':
          type: string
          default: CostarArticleContact
        id:
          type: string
        key:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
        job_title:
          anyOf:
            - type: string
            - type: 'null'
        company_name:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - id
    CostarArticleFund:
      properties:
        '@type':
          type: string
          default: CostarArticleFund
        id:
          type: string
        key:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - id
    CostarRelatedArticle:
      properties:
        '@type':
          type: string
          default: CostarRelatedArticle
        id:
          type: string
        article_title:
          anyOf:
            - type: string
            - type: 'null'
        alias:
          anyOf:
            - type: string
            - type: 'null'
        category:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - id
    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

````