Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Feedico User API
version: 1.0.0
description: 'REST API for Feedico (`api.feedico.io`).
**Auth flow**
- `POST /api/v1/auth/login` - account email, password, and your **API token** (`fdco_...` from the Account panel). Returns a **session JWT** (`sessionToken`).
- `GET /api/v1/me` - send the **raw API token** in `Authorization: Bearer fdco_...` (not the session JWT).
- `GET/PATCH /api/v1/me/profile` - **session only** (JWT from login or `feedico_session` cookie after dashboard sign-in). **Not** `fdco_`. Read/update name, company, website; **email is read-only**.
- `POST /api/v1/auth/forgot-password` - public; sends reset email (configure `RESEND_API_KEY` in production).
- `POST /api/v1/auth/reset-password` - public; `token` from email link + `newPassword`.
- `PATCH /api/v1/me/password` - **session only**; change password with `currentPassword` + `newPassword`.
**Edge**
- `GET /health` is answered by the proxy in front of Next.js (port 3100), not by a Next route.'
servers:
- url: https://api.feedico.io
description: Production
- url: http://127.0.0.1:3100
description: Local API proxy → Next
- url: http://localhost:3001
description: Next.js direct
tags:
- name: User
paths:
/api/v1/me:
get:
tags:
- User
summary: Current user (API token)
description: 'Authenticate with the **full raw API token** (`fdco_...`) from the Account panel.
This is **not** the `sessionToken` JWT from login.'
operationId: me
security:
- ApiTokenBearer: []
responses:
'200':
description: Token resolved to a user
content:
application/json:
schema:
$ref: '#/components/schemas/MeSuccess'
'401':
description: Missing or invalid bearer token
content:
application/json:
schema:
$ref: '#/components/schemas/MeError'
components:
schemas:
MeError:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
MeSuccess:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true