GET
/
api
/
v1
/
articles
curl --request GET \
  --url https://www.suprsonic.com/api/v1/articles \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "customer_avatar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "category": "opinion_piece",
      "title": "<string>",
      "slug": "<string>",
      "meta_description": "<string>",
      "hero_image_url": "<string>",
      "tags": [
        "<string>"
      ],
      "status": "draft",
      "publish_date": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "_links": {
        "self": "<string>",
        "account": "<string>"
      }
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 100,
      "totalPages": 5,
      "hasNext": true,
      "hasPrev": false
    },
    "links": {
      "self": "/api/v1/articles?page=1",
      "next": "/api/v1/articles?page=2",
      "prev": null,
      "first": "/api/v1/articles?page=1",
      "last": "/api/v1/articles?page=5"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Admin API key for managing accounts and creating content

Query Parameters

​
q
string

Search articles by title or meta description

​
tags
string

Filter by tags (comma-separated)

​
category
enum<string>

Filter by article category

Available options:
opinion_piece,
industry_forecast,
how_to_guide,
comparison,
deep_research,
checklist,
roundup
​
status
enum<string>

Filter by article status

Available options:
draft,
published,
archived,
deleted
​
page
integer
default:1

Page number for pagination

Required range: x >= 1
​
limit
integer
default:20

Number of items per page

Required range: 1 <= x <= 100

Response

200
application/json

Successfully retrieved articles

The response is of type object.