Submissions API

API documentation for submitting URLs for review and accessing approved submissions. All submissions go through an admin approval process before appearing publicly on the site.

Review Process: Submitted URLs are reviewed by administrators before being approved for public display. Only approved submissions appear in the public listings.

🔐 Authentication

Bearer Token Required: Some endpoints require authentication using Laravel Sanctum tokens.

Example Authorization Header:

Authorization: Bearer your-api-token-here

🌐 Base URL

https://counter.effectix.net
POST /api/submissions

Submit for Review

🔒 Auth Required
⏱️ 2 requests per 5 minutes

Submit a URL for admin review and approval.

Request Parameters

Parameter Type Required Description
url string Required Valid URL to submit for review

Responses

200 Success
Example Response:
{
    "success": true,
    "message": "Your submission has been received and is awaiting approval.",
    "submission": {
        "id": 1,
        "url": "https://example.com",
        "headline": null,
        "is_approved": false,
        "approved_at": null,
        "created_at": "2024-01-01T00:00:00.000000Z",
        "updated_at": "2024-01-01T00:00:00.000000Z",
        "user": {
            "id": 1,
            "name": "John Doe"
        },
        "approver": null
    }
}
GET /api/submissions

List Approved Submissions

🔒 Auth Required
⏱️ 60 requests per minute

Get a paginated list of approved submissions.

Request Parameters

Parameter Type Required Description
page integer Optional Page number for pagination (default: 1)
per_page integer Optional Items per page (default: 15)

Responses

200 Success
Example Response:
{
    "data": [
        {
            "id": 1,
            "url": "https://example.com",
            "headline": "Example Headline",
            "is_approved": true,
            "approved_at": "2024-01-01T12:00:00.000000Z",
            "created_at": "2024-01-01T00:00:00.000000Z",
            "updated_at": "2024-01-01T12:00:00.000000Z",
            "user": {
                "id": 1,
                "name": "John Doe"
            },
            "approver": {
                "id": 2,
                "name": "Admin User"
            }
        }
    ],
    "links": {
        "first": "http://example.com/api/submissions?page=1",
        "last": "http://example.com/api/submissions?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "per_page": 15,
        "to": 1,
        "total": 1
    }
}
GET /api/submissions/{id}

Get Specific Submission

🔒 Auth Required
⏱️ 60 requests per minute

Retrieve details for a specific submission by ID.

Request Parameters

Parameter Type Required Description
id integer Required Submission ID

Responses

200 Success
Example Response:
{
    "data": {
        "id": 1,
        "url": "https://example.com",
        "headline": "Example Headline",
        "is_approved": true,
        "approved_at": "2024-01-01T12:00:00.000000Z",
        "created_at": "2024-01-01T00:00:00.000000Z",
        "updated_at": "2024-01-01T12:00:00.000000Z",
        "user": {
            "id": 1,
            "name": "John Doe"
        },
        "approver": {
            "id": 2,
            "name": "Admin User"
        }
    }
}
404 Submission not found
Example Response:
{
    "message": "No query results for model [App\\Models\\Submission] 999"
}

Need help? Contact the development team or check our source code for more details.

Last updated: December 19, 2025