FOforem
articles

Perform a semantic fuzzy search on articles

Changed on

Allows authenticated clients to search articles using Forem's hybrid lexical (Algolia/database) and semantic embeddings search pipeline, with optional Jev shortlist re-ranking.

get/api/articles/semantic_search

Request

  • Base URL
    https://dev.to
  • Auth
    • API key in header api-key
    • or HTTP bearer

Query parameters

qstring required

The search query term to match semantically.

per_pageinteger

Limit of articles returned (default 30, max 100).

pageinteger

Pagination page index.

thresholdnumber

Optional cosine distance threshold (between 0.0 and 2.0) to filter results.

Response

successful

idinteger
titlestring
descriptionstring nullable
cover_imagestring nullable
slugstring
pathstring
urlstring
comments_countinteger
public_reactions_countinteger
published_atstring
distancenumber
similaritynumber

Changes