daily-dev Feeds API

openapi: 3.2.0
info:
  title: Daily Dev Feeds API
  version: 1.0.0
  description: 'Operations tagged feeds across 2 of this provider''s published API definitions: daily-dev-openapi.json, daily-dev-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.daily.dev/public/v1
security:
- bearerAuth: []
tags:
- name: Feeds
paths:
  /feeds/foryou:
    get:
      operationId: getFeedsForyou
      summary: Get For You feed
      tags:
      - Feeds
      description: Get personalized "For You" feed. With explain=true, every post also says why For You ranked it where it did.
      parameters:
      - schema:
          type: integer
          default: 20
          maximum: 50
          minimum: 1
        in: query
        name: limit
        required: false
        description: Number of posts to return (1-50)
      - schema:
          type: string
        in: query
        name: cursor
        required: false
        description: Pagination cursor from previous response
      - schema:
          type: boolean
          default: false
        in: query
        name: explain
        required: false
        description: 'Add explain to every post: why For You ranked it where it did, with the score''s factors (engagement, topic match, follow, freshness, seen before, variety) and the reader''s controls that applied. Only posts from the personalized ranking (explain.lane chal) carry more than the lane. If For You served the first page in the last few minutes, the first page with explain is that same page, so it explains what the reader just got.'
      security:
      - bearerAuth: []
      - oauth2:
        - read
      x-mcp-open-world: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/def-20'
                  pagination:
                    $ref: '#/components/schemas/def-22'
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/def-23'
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/def-23'
        '429':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/def-24'
    servers:
    - url: https://api.daily.dev/public/v1
  /feeds/popular:
    get:
      operationId: getFeedsPopular
      summary: Get trending posts
      tags:
      - Feeds
      description: Get feed with trending and popular posts
      parameters:
      - schema:
          type: integer
          default: 20
          maximum: 50
          minimum: 1
        in: query
        name: limit
        required: false
        description: Number of posts to return (1-50)
      - schema:
          type: string
        in: query
        name: cursor
        required: false
        description: Pagination cursor from previous response
      - schema:
          type: string
        in: query
        name: tags
        required: false
        description: Comma-separated list of tags to filter by (up to 20)
      security:
      - bearerAuth: []
      - oauth2:
        - read
      x-mcp-open-world: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/def-18'
                  pagination:
                    $ref: '#/components/schemas/def-22'
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/def-23'
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/def-23'
        '429':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/def-24'
    servers:
    - url: https://api.daily.dev/public/v1
  /feeds/discussed:
    get:
      operationId: getFeedsDiscussed
      summary: Get most discussed posts
      tags:
      - Feeds
      description: Get feed of posts with discussions
      parameters:
      - schema:
          type: integer
          default: 20
          maximum: 50
          minimum: 1
        in: query
        name: limit
        required: false
        description: Number of posts to return (1-50)
      - schema:
          type: string
        in: query
        name: cursor
        required: false
        description: Pagination cursor from previous response
      - schema:
          type: integer
          enum:
          - 7
          - 30
          - 365
        in: query
        name: period
        required: false
        description: 'Days since publication to look back: 7 (default), 30 or 365. Posts are ranked by comment count within that window.'
      - schema:
          type: string
        in: query
        name: tag
        required: false
        description: Filter by tag
      - schema:
          type: string
        in: query
        name: source
        required: false
        description: Filter by source ID
      security:
      - bearerAuth: []
      - oauth2:
        - read
      x-mcp-open-world: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/def-18'
                  pagination:
                    $ref: '#/components/schemas/def-22'
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/def-23'
        '429':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/def-24'
    servers:
    - url: https://api.daily.dev/public/v1
  /feeds/tag/{tag}:
    get:
      operationId: getFeedsTagTag
      summary: Get posts by tag
      tags:
      - Feeds
      parameters:
      - schema:
          type: integer
          default: 20
          maximum: 50
          minimum: 1
        in: query
        name: limit
        required: false
        description: Number of posts to return (1-50)
      - schema:
          type: string
        in: query
        name: cursor
        required: false
        description: Pagination cursor from previous response
      - schema:
          type: string
        in: path
        name: tag
        required: true
        description: Tag name
      security:
      - bearerAuth: []
      - oauth2:
        - read
      x-mcp-open-world: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/def-18'
                  pagination:
                    $ref: '#/components/schemas/def-22'
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/def-23'
        '429':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/def-24'
    servers:
    - url: https://api.daily.dev/public/v1
  /feeds/source/{source}:
    get:
      operationId: getFeedsSourceSource
      summary: Get posts by source
      tags:
      - Feeds
      parameters:
      - schema:
          type: integer
          default: 20
          maximum: 50
          minimum: 1
        in: query
        name: limit
        required: false
        description: Number of posts to return (1-50)
      - schema:
          type: string
        in: query
        name: cursor
        required: false
        description: Pagination cursor from previous response
      - schema:
          type: string
        in: path
        name: source
        required: true
        description: Source ID or handle
      security:
      - bearerAuth: []
      - oauth2:
        - read
      x-mcp-open-world: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/def-18'
                  pagination:
                    $ref: '#/components/schemas/def-22'
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/def-23'
        '429':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/def-24'
    servers:
    - url: https://api.daily.dev/public/v1
components:
  schemas:
    def-18:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        url:
          type: string
          format: uri
        image:
          type:
          - string
          - 'null'
          format: uri
        summary:
          type:
          - string
          - 'null'
        type:
          type: string
          description: Post type (article, share, etc.)
        publishedAt:
          type:
          - string
          - 'null'
          format: date-time
        createdAt:
          type: string
          format: date-time
        commentsPermalink:
          type: string
          format: uri
        source:
          $ref: '#/components/schemas/def-0'
        tags:
          type: array
          items:
            type: string
        readTime:
          type:
          - integer
          - 'null'
        numUpvotes:
          type: integer
        numComments:
          type: integer
        author:
          $ref: '#/components/schemas/def-17'
      title: FeedPost
    def-24:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
        retryAfter:
          type: integer
        limit:
          type: integer
        duration:
          type: integer
      title: RateLimitError
    def-17:
      type:
      - object
      - 'null'
      properties:
        id:
          type: string
        name:
          type: string
        image:
          type:
          - string
          - 'null'
          format: uri
        username:
          type:
          - string
          - 'null'
      title: AuthorWithId
    def-0:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        handle:
          type: string
        image:
          type:
          - string
          - 'null'
          format: uri
      title: Source
    def-20:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        url:
          type: string
          format: uri
        image:
          type:
          - string
          - 'null'
          format: uri
        summary:
          type:
          - string
          - 'null'
        type:
          type: string
          description: Post type (article, share, etc.)
        publishedAt:
          type:
          - string
          - 'null'
          format: date-time
        createdAt:
          type: string
          format: date-time
        commentsPermalink:
          type: string
          format: uri
        source:
          $ref: '#/components/schemas/def-0'
        tags:
          type: array
          items:
            type: string
        readTime:
          type:
          - integer
          - 'null'
        numUpvotes:
          type: integer
        numComments:
          type: integer
        author:
          $ref: '#/components/schemas/def-17'
        explain:
          $ref: '#/components/schemas/def-19'
      title: ExplainedFeedPost
    def-23:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
      title: Error
    def-22:
      type: object
      properties:
        hasNextPage:
          type: boolean
        cursor:
          type:
          - string
          - 'null'
      title: Pagination
    def-19:
      type:
      - object
      - 'null'
      additionalProperties: true
      description: 'Why For You ranked the post where it did. The score multiplies the factor fields: 1 is neutral, above 1 raises the post and below 1 lowers it. Optional fields are absent rather than null.'
      properties:
        lane:
          type: string
          description: What put the post in For You. chal is the personalized ranking and the only lane with the fields below; other lanes, such as popular fill-ins, carry only lane.
        v:
          type: integer
          description: Version of this shape
        score:
          type: number
          description: The score For You orders by, highest first. It has no fixed scale.
        position:
          type: integer
          description: Where the post was placed, absent when the ranking did not pick it
        base:
          type: object
          additionalProperties: true
          properties:
            value:
              type: number
              description: A score multiplier. How much readers clicked, upvoted and commented on the post compared with a typical post.
            prior_lift:
              type: number
              description: How far the source's past engagement lifts a post with few readers yet above the platform average
            viewers:
              type: integer
              description: Readers the post was shown to
        match:
          type: object
          additionalProperties: true
          description: The reader's topic that matches the post best, absent when a follow alone brought it in
          properties:
            tag:
              type: string
            origin:
              type: string
              description: 'declared: followed, inferred: learned from reading, set: given a weight by the reader'
            role:
              type: string
              description: central when the post is about the topic, side when it only touches it
            role_weight:
              type: number
              description: How much the role counts toward the topic match
            strength:
              type: string
              description: 'How much reading backs the topic: strong, moderate, confirmed or early_signal'
            weight:
              type: number
              description: The topic's weight after the reader's control
            computed_weight:
              type: number
              description: The topic's weight before the reader's control
            recency:
              type: number
            stories:
              type: integer
              description: Stories on the topic the reader acted on positively
            hidden_stories:
              type: integer
              description: Stories on the topic the reader hid
            hide_penalty:
              type: number
              description: What the hidden stories took off the weight
            control:
              type: string
              description: 'The reader''s control on the topic: boost, demote, stop_learning or weight'
            factor:
              type: number
              description: A score multiplier. Topic match.
        follow:
          type: object
          additionalProperties: true
          properties:
            kind:
              type: string
              description: 'source, squad or author: the follow that counted, absent without one'
            factor:
              type: number
              description: A score multiplier. Follow, with the level the reader set on the source or author.
            source_control:
              type: string
              description: 'The reader''s control on the post''s source: boost, demote, off or weight'
            author_control:
              type: string
              description: 'The reader''s control on the post''s author: boost, demote, off or weight'
        age:
          type: object
          additionalProperties: true
          properties:
            days:
              type: number
              description: Days since the post came out
            factor:
              type: number
              description: 'A score multiplier. Freshness: older posts slowly fade.'
        seen:
          type: object
          additionalProperties: true
          properties:
            shows:
              type: integer
              description: Times For You already showed the post to the reader
            factor:
              type: number
              description: A score multiplier. Seen before.
        slot:
          type: object
          additionalProperties: true
          description: The variety adjustments, only on picked posts
          properties:
            source_repeat:
              type: number
              description: A score multiplier. Lowers the post when the feed already has posts from its source.
            topic_repeat:
              type: number
              description: A score multiplier. Lowers the post when the feed already has posts on its topic.
            same_headline:
              type: number
              description: A score multiplier. Lowers the post when the feed already covers the same story.
            waiting:
              type: number
              description: 'A score multiplier. Topic''s turn: raises a topic the reader likes that has not shown up for a while.'
            waiting_tag:
              type: string
              description: The topic whose turn it was
            pick_score:
              type: number
              description: The score after these adjustments
        reasons:
          type: array
          items:
            type: string
          description: 'Only on a left-out post: why For You left it out'
      title: FeedPostExplain
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Personal Access Token from https://daily.dev/settings/api
    oauth2:
      type: oauth2
      description: OAuth 2.0 access token for an app registered at https://daily.dev/settings/api. Request it with resource=https://api.daily.dev/public/v1.
      flows:
        authorizationCode:
          authorizationUrl: https://api.daily.dev/auth/oauth2/authorize
          tokenUrl: https://api.daily.dev/auth/oauth2/token
          refreshUrl: https://api.daily.dev/auth/oauth2/token
          scopes:
            read: Read your daily.dev data
            write: Change your daily.dev data
x-refined-from:
- daily-dev-openapi.json
- daily-dev-openapi.json