Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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: Generect Auth API
description: 'Welcome to the Generect API documentation. Here we will help you integrate and use our API.
API base url: `https://api.generect.com` — every path below is relative to this host. Newer endpoints live under `/api/v1/...`, legacy endpoints under `/api/...`; use each path exactly as documented.
Protocol: `HTTPS`
# Authentication
Get your API token from the Generect app settings and send it in the `Authorization` header with the required `Token` prefix.
Example: `Authorization: Token xxxxxxxxx`
# Rate limits
There is no monthly request quota. What you can run is bounded by your account balance and by the parallel-request caps on the Limits page. Pricing depends on the operation and the number of results returned, and may increase with additional data flags. For exact pricing, see each endpoint''s Pricing section or your billing settings: https://app.generect.com/settings/billing
# Note
_Every endpoint must include the trailing `/`. Requests without the trailing slash may fail._'
version: 1.0.0
contact: {}
servers:
- url: https://api.generect.com
security:
- apiKey: []
tags:
- name: Auth
paths:
/api/auth/transactions/spent_credits/:
get:
summary: Fetch spent credits transactions
description: Retrieve a list of spent credits transactions based on the specified period and date range.
parameters:
- name: timezone
in: query
description: Timezone for date calculations
required: true
schema:
type: string
- name: period
in: query
description: The aggregation period for transactions
required: true
schema:
type: string
enum:
- day
- week
- month
- quarter
- year
- name: start_date
in: query
description: The start date for the transaction filter (ISO 8601 format)
required: true
schema:
type: string
format: date
- name: end_date
in: query
description: The end date for the transaction filter (ISO 8601 format)
required: true
schema:
type: string
format: date
responses:
'200':
description: A list of transactions for the specified period and date range
content:
application/json:
schema:
type: object
properties:
spent_credits:
type: object
additionalProperties:
type: object
additionalProperties:
type: number
example:
'2025-01-01T00:00:00':
/api/linkedin/leads/by_icp/: -4428.0
/api/linkedin/companies/by_icp/: -39.0
/api/linkedin/company/by_link/: -5.0
/api/linkedin/lead/by_link/: -3.0
/api/linkedin/email_finder/: -1.0
platform: -9.0
'2024-12-01T00:00:00':
/api/linkedin/leads/by_icp/: -383.0
/api/linkedin/company/by_link/: -17.0
/api/linkedin/companies/by_icp/: -156.0
/api/linkedin/lead/by_link/: -6.0
platform: -12.0
'2024-11-01T00:00:00':
/api/linkedin/companies/by_icp/: -101.0
/api/linkedin/leads/by_icp/: -1720.0
platform: -1469.0
total_spent_credits:
type: number
example: -8349.0
security:
- apiKey: []
tags:
- Auth
operationId: getApiAuthTransactionsSpentCredits
x-operation-id-source: derived
components:
securitySchemes:
apiKey:
type: apiKey
in: header
name: Authorization
description: 'Use the required Token prefix. Example: Authorization: Token xxxxxxxxx'