Overview
Access Forem articles, users and other resources via API. For a real-world example of Forem in action, check out [DEV](https://www.dev.to). All endpoints can be accessed with the 'api-key' header and a accept header, but some of them are accessible publicly without authentication. Dates and date times, unless otherwise specified, must be in the [RFC 3339](https://tools.ietf.org/html/rfc3339) format.
Forem API V1 is a social API from dev.to. Requests are authenticated with an API key. It is served over HTTPS. Its OpenAPI description documents 40 endpoints.
At a glance
- Authentication
- API key
- HTTPS
- Yes
- CORS
- Unknown
- Category
- Social
- Base URL
https://dev.to/api- Version
- 1.0.0
- Endpoints
- 40
- OpenAPI
- Specification ↗
- Spec updated
- 2023-03-07
Make a first request
Replace the placeholders; the documentation says exactly where credentials go.
curl -X GET "https://dev.to/api/api/articles" \
-H "Accept: application/json" \
-H "X-API-Key: YOUR_API_KEY"const response = await fetch("https://dev.to/api/api/articles", {
method: "GET",
headers: {
"Accept": "application/json",
"X-API-Key": "YOUR_API_KEY",
},
});
const data = await response.json();
console.log(data);import requests
response = requests.request(
"GET",
"https://dev.to/api/api/articles",
headers={
"Accept": "application/json",
"X-API-Key": "YOUR_API_KEY",
},
timeout=30,
)
print(response.json())Endpoints
| Method | Path | What it does |
|---|---|---|
| POST | /api/admin/users | Invite a User |
| GET | /api/articles | Published articles |
| POST | /api/articles | Publish article |
| GET | /api/articles/latest | Published articles sorted by published date |
| GET | /api/articles/me | User's articles |
| GET | /api/articles/me/all | User's all articles |
| GET | /api/articles/me/published | User's published articles |
| GET | /api/articles/me/unpublished | User's unpublished articles |
| GET | /api/articles/{id} | Published article by id |
| PUT | /api/articles/{id} | Update an article by id |
| PUT | /api/articles/{id}/unpublish | Unpublish an article |
| GET | /api/articles/{username}/{slug} | Published article by path |
| GET | /api/comments | Comments |
| GET | /api/comments/{id} | Comment by id |
| GET | /api/display_ads | display ads |
| POST | /api/display_ads | display ads |
| GET | /api/display_ads/{id} | display ad |
| PUT | /api/display_ads/{id} | display ads |
| PUT | /api/display_ads/{id}/unpublish | unpublish |
| GET | /api/followers/users | Followers |
| GET | /api/follows/tags | Followed Tags |
| GET | /api/organizations/{username} | An organization |
| GET | /api/organizations/{username}/articles | Organization's Articles |
| GET | /api/organizations/{username}/users | Organization's users |
| GET | /api/pages | show details for all pages |
| POST | /api/pages | pages |
| GET | /api/pages/{id} | show details for a page |
| PUT | /api/pages/{id} | update details for a page |
| DELETE | /api/pages/{id} | remove a page |
| GET | /api/podcast_episodes | Podcast Episodes |
| GET | /api/profile_images/{username} | A Users or organizations profile image |
| POST | /api/reactions | create reaction |
| POST | /api/reactions/toggle | toggle reaction |
| GET | /api/readinglist | Readinglist |
| GET | /api/tags | Tags |
| GET | /api/users/me | The authenticated user |
| GET | /api/users/{id} | A User |
| PUT | /api/users/{id}/suspend | Suspend a User |
| PUT | /api/users/{id}/unpublish | Unpublish a User's Articles and Comments |
| GET | /api/videos | Articles with a video |
Questions
Does the Forem API V1 API need an API key?
Yes. The Forem API V1 API uses API key authentication; the documentation explains how to get credentials.
Does the Forem API V1 API support HTTPS?
Yes, the Forem API V1 API is served over HTTPS.
How many endpoints does the Forem API V1 API have?
Its OpenAPI description lists 40 endpoints in version 1.0.0. All of them are shown on this page.
What are alternatives to the Forem API V1 API?
Other Social APIs include Blogger, Facebook, Twitter, Pinterest, TikTok.
Similar social APIs
Compare alternatives →Blogger
SocialThe Blogger APIs allows client applications to view and update Blogger content
Facebook Login, Share on FB, Social Plugins, Analytics and more
Read and write Twitter data
The world's catalog of ideas
TikTok
SocialFetches user info and user's video posts on TikTok platform
Twitter API
SocialUse the X API with an all-new Developer Console and consumption-based billing. No fixed monthly costs, no monthly caps.
Listed from APIs.guru (CC0).