/api/v1/projects
List projects
/api/v1/projects
List projects
Endpoint
- Method:
GET - Path:
/api/v1/projects
Base URL
https://api.mentionkit.com
Authentication
Use Authorization: Bearer YOUR_API_KEY.
Parameters
No parameters.
Responses
200: Projects fetched successfully.
- Content-Type:
application/json - Schema:
ProjectListResponse - Example:
{
"items": [
{
"id": 3001,
"name": "Example Project",
"siteDomain": "example.com",
"bizName": "ExampleCo",
"description": "ExampleCo helps teams monitor social mentions and respond faster.",
"companyMoat": "- Faster setup\n- Clearer alerts",
"targetCustomer": "- Small marketing teams\n- Agency owners",
"customerProblems": "- Important posts get missed\n- Manual monitoring takes too long",
"conversationGuidance": "## Lead generation\n- People asking for a social monitoring tool",
"type": "ECOM",
"faviconUrl": "https://example.com/favicon.ico",
"createdAt": "2026-03-21T00:26:05.651Z",
"updatedAt": "2026-03-24T01:29:08.985Z"
}
],
"total": 1
}401: Missing or invalid API key.
- Content-Type:
application/json - Schema:
ErrorResponse
403: API access blocked. The organization is deactivated for API usage and must have an active trial, active paid subscription, or billing exemption.
- Content-Type:
application/json - Schema:
ErrorResponse - Example:
{
"error": "API access requires a trial, paid subscription, or billing exemption"
}500: Unexpected server error.
- Content-Type:
application/json - Schema:
ErrorResponse
Error codes
401: Missing or invalid API key.403: API access blocked. The organization is deactivated for API usage and must have an active trial, active paid subscription, or billing exemption.500: Unexpected server error.
