AYLIEN related_story API

The related_story API from AYLIEN — 1 operation(s) for related_story.

Operations 2

POST /related_stories #
GET /related_stories #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/aylien-related-story-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

aylien-related-story-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  contact:
    email: support@aylien.com
    name: API support
    url: https://newsapi.aylien.com/
  description: 'The AYLIEN News API is the most powerful way of sourcing, searching and syndicating analyzed and enriched news content. It is accessed by sending HTTP requests to our server, which returns information to your client.

    '
  termsOfService: https://newsapi.aylien.com/tos
  title: AYLIEN News Absa Related Story API
  version: '3.0'
servers:
- url: https://api.aylien.com/news
tags:
- name: related_story
paths:
  /related_stories:
    description: 'This endpoint is used for finding semantically similar stories based on the parameters you provide as inputs. For example, if you want to find stories similar to a Tweet or any text extract you input, the related stories endpoint will analyze the entities present and the meaning of the text, and find stories with a similar meaning. The maximum number of related stories returned is 100.

      '
    summary: List related stories
    parameters:
    - $ref: '#/components/parameters/id'
    - $ref: '#/components/parameters/notid'
    - $ref: '#/components/parameters/title'
    - $ref: '#/components/parameters/body'
    - $ref: '#/components/parameters/text'
    - $ref: '#/components/parameters/translations_en_title'
    - $ref: '#/components/parameters/translations_en_body'
    - $ref: '#/components/parameters/translations_en_text'
    - $ref: '#/components/parameters/links_permalink'
    - $ref: '#/components/parameters/notlinks_permalink'
    - $ref: '#/components/parameters/language'
    - $ref: '#/components/parameters/notlanguage'
    - $ref: '#/components/parameters/published_at_start'
    - $ref: '#/components/parameters/published_at_end'
    - $ref: '#/components/parameters/categories_taxonomy'
    - $ref: '#/components/parameters/categories_confident'
    - $ref: '#/components/parameters/categories_id'
    - $ref: '#/components/parameters/notcategories_id'
    - $ref: '#/components/parameters/categories_label'
    - $ref: '#/components/parameters/notcategories_label'
    - $ref: '#/components/parameters/categories_level'
    - $ref: '#/components/parameters/notcategories_level'
    - $ref: '#/components/parameters/entities_title_id'
    - $ref: '#/components/parameters/notentities_title_id'
    - $ref: '#/components/parameters/entities_title_surface_forms_text'
    - $ref: '#/components/parameters/notentities_title_surface_forms_text'
    - $ref: '#/components/parameters/entities_title_text'
    - $ref: '#/components/parameters/notentities_title_text'
    - $ref: '#/components/parameters/entities_title_type'
    - $ref: '#/components/parameters/notentities_title_type'
    - $ref: '#/components/parameters/entities_title_stock_ticker'
    - $ref: '#/components/parameters/notentities_title_stock_ticker'
    - $ref: '#/components/parameters/entities_title_links_dbpedia'
    - $ref: '#/components/parameters/notentities_title_links_dbpedia'
    - $ref: '#/components/parameters/entities_title_links_wikipedia'
    - $ref: '#/components/parameters/notentities_title_links_wikipedia'
    - $ref: '#/components/parameters/entities_title_links_wikidata'
    - $ref: '#/components/parameters/notentities_title_links_wikidata'
    - $ref: '#/components/parameters/entities_body_id'
    - $ref: '#/components/parameters/notentities_body_id'
    - $ref: '#/components/parameters/entities_body_surface_forms_text'
    - $ref: '#/components/parameters/notentities_body_surface_forms_text'
    - $ref: '#/components/parameters/entities_body_text'
    - $ref: '#/components/parameters/notentities_body_text'
    - $ref: '#/components/parameters/entities_body_type'
    - $ref: '#/components/parameters/notentities_body_type'
    - $ref: '#/components/parameters/entities_body_stock_ticker'
    - $ref: '#/components/parameters/notentities_body_stock_ticker'
    - $ref: '#/components/parameters/entities_body_links_dbpedia'
    - $ref: '#/components/parameters/notentities_body_links_dbpedia'
    - $ref: '#/components/parameters/entities_body_links_wikipedia'
    - $ref: '#/components/parameters/notentities_body_links_wikipedia'
    - $ref: '#/components/parameters/entities_body_links_wikidata'
    - $ref: '#/components/parameters/notentities_body_links_wikidata'
    - $ref: '#/components/parameters/sentiment_title_polarity'
    - $ref: '#/components/parameters/notsentiment_title_polarity'
    - $ref: '#/components/parameters/sentiment_body_polarity'
    - $ref: '#/components/parameters/notsentiment_body_polarity'
    - $ref: '#/components/parameters/media_images_count_min'
    - $ref: '#/components/parameters/media_images_count_max'
    - $ref: '#/components/parameters/media_images_width_min'
    - $ref: '#/components/parameters/media_images_width_max'
    - $ref: '#/components/parameters/media_images_height_min'
    - $ref: '#/components/parameters/media_images_height_max'
    - $ref: '#/components/parameters/media_images_content_length_min'
    - $ref: '#/components/parameters/media_images_content_length_max'
    - $ref: '#/components/parameters/media_images_format'
    - $ref: '#/components/parameters/notmedia_images_format'
    - $ref: '#/components/parameters/media_videos_count_min'
    - $ref: '#/components/parameters/media_videos_count_max'
    - $ref: '#/components/parameters/author_id'
    - $ref: '#/components/parameters/notauthor_id'
    - $ref: '#/components/parameters/author_name'
    - $ref: '#/components/parameters/notauthor_name'
    - $ref: '#/components/parameters/source_id'
    - $ref: '#/components/parameters/notsource_id'
    - $ref: '#/components/parameters/source_name'
    - $ref: '#/components/parameters/notsource_name'
    - $ref: '#/components/parameters/source_domain'
    - $ref: '#/components/parameters/notsource_domain'
    - $ref: '#/components/parameters/source_locations_country'
    - $ref: '#/components/parameters/notsource_locations_country'
    - $ref: '#/components/parameters/source_locations_state'
    - $ref: '#/components/parameters/notsource_locations_state'
    - $ref: '#/components/parameters/source_locations_city'
    - $ref: '#/components/parameters/notsource_locations_city'
    - $ref: '#/components/parameters/source_scopes_country'
    - $ref: '#/components/parameters/notsource_scopes_country'
    - $ref: '#/components/parameters/source_scopes_state'
    - $ref: '#/components/parameters/notsource_scopes_state'
    - $ref: '#/components/parameters/source_scopes_city'
    - $ref: '#/components/parameters/notsource_scopes_city'
    - $ref: '#/components/parameters/source_scopes_level'
    - $ref: '#/components/parameters/notsource_scopes_level'
    - $ref: '#/components/parameters/source_links_in_count_min'
    - $ref: '#/components/parameters/source_links_in_count_max'
    - $ref: '#/components/parameters/source_rankings_alexa_rank_min'
    - $ref: '#/components/parameters/source_rankings_alexa_rank_max'
    - $ref: '#/components/parameters/source_rankings_alexa_country'
    - $ref: '#/components/parameters/social_shares_count_facebook_min'
    - $ref: '#/components/parameters/social_shares_count_facebook_max'
    - $ref: '#/components/parameters/social_shares_count_google_plus_min'
    - $ref: '#/components/parameters/social_shares_count_google_plus_max'
    - $ref: '#/components/parameters/social_shares_count_linkedin_min'
    - $ref: '#/components/parameters/social_shares_count_linkedin_max'
    - $ref: '#/components/parameters/social_shares_count_reddit_min'
    - $ref: '#/components/parameters/social_shares_count_reddit_max'
    - $ref: '#/components/parameters/clusters'
    - $ref: '#/components/parameters/return'
    - $ref: '#/components/parameters/story_id'
    - $ref: '#/components/parameters/story_url'
    - $ref: '#/components/parameters/story_title'
    - $ref: '#/components/parameters/story_body'
    - description: 'This parameter is used for boosting the result by the specified value.

        '
      in: query
      name: boost_by
      schema:
        enum:
        - recency
        - popularity
        type:
        - string
        - 'null'
    - $ref: '#/components/parameters/story_language'
    - $ref: '#/components/parameters/per_page'
    post:
      tags:
      - related_story
      operationId: listRelatedStoriesPost
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelatedStories'
            text/xml:
              schema:
                $ref: '#/components/schemas/RelatedStories'
          description: An object including an array of related stories
          headers:
            X-RateLimit-Limit:
              description: The number of allowed requests in the current period.
              schema:
                format: int32
                type: integer
            X-RateLimit-Remaining:
              description: The number of remaining requests in the current period.
              schema:
                format: int32
                type: integer
            X-RateLimit-Reset:
              description: 'The remaining window before the rate limit resets in UTC [epoch seconds](https://en.wikipedia.org/wiki/Unix_time).

                '
              schema:
                format: int64
                type: integer
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
            text/xml:
              schema:
                $ref: '#/components/schemas/Errors'
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
            text/xml:
              schema:
                $ref: '#/components/schemas/Errors'
          description: Not Found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
            text/xml:
              schema:
                $ref: '#/components/schemas/Errors'
          description: Unprocessable Entity
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
            text/xml:
              schema:
                $ref: '#/components/schemas/Errors'
          description: Too Many Requests
          headers:
            X-RateLimit-Limit:
              description: The number of allowed requests in the current period.
              schema:
                format: int32
                type: integer
            X-RateLimit-Remaining:
              description: The number of remaining requests in the current period.
              schema:
                format: int32
                type: integer
            X-RateLimit-Reset:
              description: 'The remaining window before the rate limit resets in UTC [epoch seconds](https://en.wikipedia.org/wiki/Unix_time).

                '
              schema:
                format: int64
                type: integer
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
            text/xml:
              schema:
                $ref: '#/components/schemas/Errors'
          description: Internal Server Error
      security:
      - app_id: []
      - app_key: []
    get:
      tags:
      - related_story
      operationId: listRelatedStoriesGet
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RelatedStories'
            text/xml:
              schema:
                $ref: '#/components/schemas/RelatedStories'
          description: An object including an array of related stories
          headers:
            X-RateLimit-Limit:
              description: The number of allowed requests in the current period.
              schema:
                format: int32
                type: integer
            X-RateLimit-Remaining:
              description: The number of remaining requests in the current period.
              schema:
                format: int32
                type: integer
            X-RateLimit-Reset:
              description: 'The remaining window before the rate limit resets in UTC [epoch seconds](https://en.wikipedia.org/wiki/Unix_time).

                '
              schema:
                format: int64
                type: integer
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
            text/xml:
              schema:
                $ref: '#/components/schemas/Errors'
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
            text/xml:
              schema:
                $ref: '#/components/schemas/Errors'
          description: Not Found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
            text/xml:
              schema:
                $ref: '#/components/schemas/Errors'
          description: Unprocessable Entity
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
            text/xml:
              schema:
                $ref: '#/components/schemas/Errors'
          description: Too Many Requests
          headers:
            X-RateLimit-Limit:
              description: The number of allowed requests in the current period.
              schema:
                format: int32
                type: integer
            X-RateLimit-Remaining:
              description: The number of remaining requests in the current period.
              schema:
                format: int32
                type: integer
            X-RateLimit-Reset:
              description: 'The remaining window before the rate limit resets in UTC [epoch seconds](https://en.wikipedia.org/wiki/Unix_time).

                '
              schema:
                format: int64
                type: integer
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
            text/xml:
              schema:
                $ref: '#/components/schemas/Errors'
          description: Internal Server Error
      security:
      - app_id: []
      - app_key: []
components:
  parameters:
    categories_confident:
      description: 'This parameter is used for finding stories whose categories are confident. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories).

        '
      in: query
      name: categories.confident
      schema:
        default: true
        type:
        - boolean
        - 'null'
    notentities_body_links_dbpedia:
      description: 'This parameter is used to exclude stories based on the specified entities dbpedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities).

        '
      explode: true
      in: query
      name: '!entities.body.links.dbpedia[]'
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    social_shares_count_linkedin_min:
      description: 'This parameter is used for finding stories whose LinkedIn social shares count is greater than or equal to the specified value.

        '
      in: query
      name: social_shares_count.linkedin.min
      schema:
        format: int32
        type:
        - integer
        - 'null'
        exclusiveMinimum: 0
    source_scopes_country:
      description: 'This parameter is used for finding stories whose source scopes is the specified country value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).

        '
      explode: true
      in: query
      name: source.scopes.country[]
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    entities_title_links_wikipedia:
      description: 'This parameter is used to find stories based on the specified entities Wikipedia URL in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities).

        '
      explode: true
      in: query
      name: entities.title.links.wikipedia[]
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    notauthor_name:
      description: 'This parameter is used for excluding stories whose author full name contains the specified value.

        '
      in: query
      name: '!author.name'
      schema:
        type:
        - string
        - 'null'
    notlinks_permalink:
      description: 'This parameter is used to exclude stories based on their url.

        '
      explode: true
      in: query
      name: '!links.permalink[]'
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    id:
      description: 'This parameter is used for finding stories by story id.

        '
      explode: true
      in: query
      name: id[]
      schema:
        items:
          format: int64
          type: integer
        type:
        - array
        - 'null'
      style: form
    source_locations_state:
      description: 'This parameter is used for finding stories whose source state/province is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).

        '
      explode: true
      in: query
      name: source.locations.state[]
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    notentities_title_stock_ticker:
      description: 'This parameter is used to exclude stories based on the specified entities `stock_ticker` in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities).

        '
      explode: true
      in: query
      name: '!entities.title.stock_ticker[]'
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    body:
      description: 'This parameter is used for finding stories whose body contains a specific keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).

        '
      in: query
      name: body
      schema:
        type:
        - string
        - 'null'
    notentities_title_links_wikidata:
      description: 'This parameter is used to exclude stories based on the specified entities Wikidata URL in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities).

        '
      explode: true
      in: query
      name: '!entities.title.links.wikidata[]'
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    media_images_width_min:
      description: 'This parameter is used for finding stories whose width of images are greater than or equal to the specified value.

        '
      in: query
      name: media.images.width.min
      schema:
        format: int32
        type:
        - integer
        - 'null'
        exclusiveMinimum: 0
    notid:
      description: 'This parameter is used for excluding stories by story id.

        '
      explode: true
      in: query
      name: '!id[]'
      schema:
        items:
          format: int64
          type: integer
        type:
        - array
        - 'null'
      style: form
    media_videos_count_min:
      description: 'This parameter is used for finding stories whose number of videos is greater than or equal to the specified value.

        '
      in: query
      name: media.videos.count.min
      schema:
        format: int32
        type:
        - integer
        - 'null'
        exclusiveMinimum: 0
    published_at_end:
      description: 'This parameter is used for finding stories whose published at time is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).

        '
      in: query
      name: published_at.end
      schema:
        type:
        - string
        - 'null'
    notentities_body_type:
      description: 'This parameter is used to exclude stories based on the specified entities `type` in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities).

        '
      explode: true
      in: query
      name: '!entities.body.type[]'
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    story_url:
      description: An article or webpage
      in: query
      name: story_url
      schema:
        type:
        - string
        - 'null'
    notlanguage:
      description: 'This parameter is used for excluding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.

        '
      explode: true
      in: query
      name: '!language[]'
      schema:
        items:
          enum:
          - en
          - de
          - fr
          - it
          - es
          - pt
          type: string
        type:
        - array
        - 'null'
      style: form
    media_images_height_max:
      description: 'This parameter is used for finding stories whose height of images are less than or equal to the specified value.

        '
      in: query
      name: media.images.height.max
      schema:
        format: int32
        type:
        - integer
        - 'null'
        exclusiveMinimum: 0
    notsource_domain:
      description: 'This parameter is used for excluding stories whose source domain is the specified value.

        '
      explode: true
      in: query
      name: '!source.domain[]'
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    notsentiment_body_polarity:
      description: 'This parameter is used for excluding stories whose body sentiment is the specified value.

        '
      in: query
      name: '!sentiment.body.polarity'
      schema:
        enum:
        - positive
        - neutral
        - negative
        type:
        - string
        - 'null'
    source_name:
      description: 'This parameter is used for finding stories whose source name contains the specified value.

        '
      explode: true
      in: query
      name: source.name[]
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    published_at_start:
      description: 'This parameter is used for finding stories whose published at time is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).

        '
      in: query
      name: published_at.start
      schema:
        type:
        - string
        - 'null'
    social_shares_count_reddit_min:
      description: 'This parameter is used for finding stories whose Reddit social shares count is greater than or equal to the specified value.

        '
      in: query
      name: social_shares_count.reddit.min
      schema:
        format: int32
        type:
        - integer
        - 'null'
        exclusiveMinimum: 0
    media_images_count_min:
      description: 'This parameter is used for finding stories whose number of images is greater than or equal to the specified value.

        '
      in: query
      name: media.images.count.min
      schema:
        format: int32
        type:
        - integer
        - 'null'
        exclusiveMinimum: 0
    entities_title_links_dbpedia:
      description: 'This parameter is used to find stories based on the specified entities dbpedia URL in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities).

        '
      explode: true
      in: query
      name: entities.title.links.dbpedia[]
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    story_body:
      description: Body of the article
      in: query
      name: story_body
      schema:
        type:
        - string
        - 'null'
    notsource_scopes_level:
      description: 'This parameter is used for excluding stories whose source scopes is the specified level value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).

        '
      explode: true
      in: query
      name: '!source.scopes.level[]'
      schema:
        items:
          enum:
          - international
          - national
          - local
          type: string
        type:
        - array
        - 'null'
      style: form
    entities_title_type:
      description: 'This parameter is used to find stories based on the specified entities `type` in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities).

        '
      explode: true
      in: query
      name: entities.title.type[]
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    source_domain:
      description: 'This parameter is used for finding stories whose source domain is the specified value.

        '
      explode: true
      in: query
      name: source.domain[]
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    media_images_format:
      description: 'This parameter is used for finding stories whose images format are the specified value.

        '
      explode: true
      in: query
      name: media.images.format[]
      schema:
        items:
          enum:
          - BMP
          - GIF
          - JPEG
          - PNG
          - TIFF
          - PSD
          - ICO
          - CUR
          - WEBP
          - SVG
          type: string
        type:
        - array
        - 'null'
      style: form
    source_scopes_level:
      description: 'This parameter is used for finding stories whose source scopes is the specified level value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).

        '
      explode: true
      in: query
      name: source.scopes.level[]
      schema:
        items:
          enum:
          - international
          - national
          - local
          type: string
        type:
        - array
        - 'null'
      style: form
    sentiment_title_polarity:
      description: 'This parameter is used for finding stories whose title sentiment is the specified value.

        '
      in: query
      name: sentiment.title.polarity
      schema:
        enum:
        - positive
        - neutral
        - negative
        type:
        - string
        - 'null'
    translations_en_text:
      description: 'This parameter is used for finding stories whose translation title or body contains a specific keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).

        '
      in: query
      name: translations.en.text
      schema:
        type:
        - string
        - 'null'
    notsource_scopes_state:
      description: 'This parameter is used for excluding stories whose source scopes is the specified state/province value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).

        '
      explode: true
      in: query
      name: '!source.scopes.state[]'
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    entities_title_surface_forms_text:
      description: 'This parameter is used to find stories based on the specified entities `surface_form` in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities).

        '
      explode: true
      in: query
      name: entities.title.surface_forms.text[]
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    source_links_in_count_max:
      description: 'This parameter is used for finding stories from sources whose Links in count is less than or equal to the specified value. You can read more about working with Links in count [here](https://newsapi.aylien.com/docs/working-with-links-in-count).

        '
      in: query
      name: source.links_in_count.max
      schema:
        format: int32
        type:
        - integer
        - 'null'
        exclusiveMinimum: 0
    entities_body_text:
      description: 'This parameter is used to find stories based on the specified entities `text` in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities).

        '
      explode: true
      in: query
      name: entities.body.text[]
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    media_images_height_min:
      description: 'This parameter is used for finding stories whose height of images are greater than or equal to the specified value.

        '
      in: query
      name: media.images.height.min
      schema:
        format: int32
        type:
        - integer
        - 'null'
        exclusiveMinimum: 0
    notentities_title_surface_forms_text:
      description: 'This parameter is used to exclude stories based on the specified entities `surface_form` in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities).

        '
      explode: true
      in: query
      name: '!entities.title.surface_forms.text[]'
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    entities_title_id:
      description: 'This parameter is used to find stories based on the specified entities `id` in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities).

        '
      explode: true
      in: query
      name: entities.title.id[]
      schema:
        items:
          type: string
        type:
        - array
        - 'null'
      style: form
    translations_en_title:
      description: 'This parameter is used for finding stories whose translation title contains a specific keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).

        '
      in: query
      name: translations.en.title
      schema:
        type:
        - string
        - 'null'
    language:
      description: 'This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.

        '
      explode: true
      in: query
      name: language[]
      schema:
        items:
          enum:
          - en
          - de
          - fr
          - it
          - es
          - pt
          type: string
        type:
        - array
        - 'null'
      style: form
    story_id:
      description: A story id
      in: query
      name: story_id
      schema:
        format: int64
        type:
        - integer
        - 'null'
    text:
      description: 'This parameter is used for finding 

# --- truncated at 32 KB (76 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/aylien/refs/heads/main/openapi/aylien-related-story-api-openapi.yml