Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Reddit Links & Comments API

Endpoints for interacting with submissions (links) and comments, including voting, saving, hiding, reporting, and submitting content.

Reddit Links & Comments API is one of 21 APIs that Reddit publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Links & Comments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

This API exposes 12 operations across 12 paths, and defines 2 schemas. It is described by OpenAPI 3.1.0, at version 3.

Requests are made against a single base URL, https://ads-api.reddit.com/api/v3.

12 operations 12 paths 2 schemas 2 GET10 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
3
Base URL
https://oauth.reddit.com
Authentication
OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 1

Reddit Links & Comments API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 1 scope. By default, every request must be authenticated.

  • oauth2 — Reddit Ads API uses OAuth 2.0 for authentication. Access tokens are obtained via the authorization code flow.

Paths & Operations 12

Across 12 paths, the API surfaces 12 operations — 2 GET, 10 POST. Each is listed below with its method, path, parameters, and response codes.

Links & Comments 12

Endpoints for interacting with submissions (links) and comments, including voting, saving, hiding, reporting, and submitting content.

GET
/comments/{article}
Get Comments for a Submission
getComments 5 params → 200
GET
/api/morechildren
Retrieve Additional Comments
getMoreChildren 4 params → 200
POST
/api/submit
Submit a New Link or Self-post
submit body → 200403
POST
/api/comment
Submit a New Comment
comment body → 200403
POST
/api/vote
Vote on a Submission or Comment
vote body → 200401
POST
/api/save
Save a Submission or Comment
save body → 200
POST
/api/unsave
Unsave a Submission or Comment
unsave body → 200
POST
/api/hide
Hide a Submission
hide body → 200
POST
/api/unhide
Unhide a Submission
unhide body → 200
POST
/api/del
Delete a Submission or Comment
del body → 200
POST
/api/editusertext
Edit a Self-post or Comment
editUserText body → 200
POST
/api/report
Report a Submission or Comment
report body → 200

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed are Thing (2 properties), Listing (2 properties). Each schema is shown below with its type and property counts.

Listing
object
A Reddit listing is a paginated collection of things. Listings contain a data object with children and pagination information.
2 properties
Thing
object
A Reddit thing is the base object type. All Reddit objects (comments, links, subreddits, etc.) are things with a kind and data payload.
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

reddit-links-comments-api-openapi.yml Raw ↑

Other APIs Reddit publishes across the network.

Reddit Ads API
Reddit OAuth 2.0 Authorization
Reddit Account API
Reddit Accounts API
Reddit Ad Groups API
Reddit Campaigns API
Reddit Conversions API
Reddit Custom Audiences API
Reddit Flair API
Reddit Funding API
Reddit Listings API
Reddit Messages API