daily-dev Recommend API

openapi: 3.2.0
info:
  title: Daily Dev Recommend API
  version: 1.0.0
  description: 'Operations tagged recommend 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: recommend
paths:
  /recommend/keyword:
    get:
      operationId: getRecommendKeyword
      summary: Recommend posts by keyword
      tags:
      - recommend
      description: '[EXPERIMENTAL] Recommend articles by keyword search. Best when the query contains specific technical terms (e.g. "RAG", "pgvector", "LangChain"). Returns posts with engagement signals for LLM consumption. Natural-language questions and long phrases usually match nothing and return an empty list; use GET /search/posts with two or three keywords for those. This endpoint may be removed or changed without notice.'
      parameters:
      - schema:
          type: string
          minLength: 1
        in: query
        name: q
        required: true
        description: Search query — keywords or technical terms (e.g. "RAG vs fine-tuning", "vector database comparison")
      - schema:
          type: integer
          default: 10
          maximum: 20
          minimum: 1
        in: query
        name: limit
        required: false
        description: Number of articles to return (1-20, default 10). Kept small for LLM context efficiency.
      - schema:
          type: string
        in: query
        name: cursor
        required: false
        description: Pagination cursor from previous response
      - schema:
          type: string
          enum:
          - day
          - week
          - month
          - year
          - all
        in: query
        name: time
        required: false
        description: Time range filter — use "month" or "year" for recent content, "all" for comprehensive results
      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
  /recommend/semantic:
    get:
      operationId: getRecommendSemantic
      summary: Recommend posts by meaning
      tags:
      - recommend
      description: '[DEPRECATED] Use /recommend/keyword instead, which this endpoint now answers from. Kept for older clients and scheduled for removal.'
      parameters:
      - schema:
          type: string
          minLength: 1
        in: query
        name: q
        required: true
        description: Natural language question or topic (e.g. "how do I make my chatbot remember previous conversations?", "what is the best way to handle authentication in a Next.js app?")
      - schema:
          type: integer
          default: 10
          maximum: 20
          minimum: 1
        in: query
        name: limit
        required: false
        description: Number of articles to return (1-20, default 10). Kept small for LLM context efficiency.
      - schema:
          type: string
          enum:
          - day
          - week
          - month
          - year
          - all
        in: query
        name: time
        required: false
        description: Time range filter — use "month" or "year" for recent content, "all" for comprehensive results
      deprecated: true
      security:
      - bearerAuth: []
      - oauth2:
        - read
      x-mcp-open-world: true
      x-mcp: false
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/def-18'
        '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
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-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
  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