API Overview
The Tellscope API is built on GraphQL, giving you the flexibility to request exactly the data you need. All requests are made to a single endpoint:
POST https://api.tellscope.io/graphql
Available Operations
Queries (Read)
| Operation | Description |
|---|
feedbackItems | List feedback with filters and pagination |
feedbackItem | Get a single feedback by ID |
contactItems | List contacts with search and pagination |
contactItem | Get a single contact by ID |
accountItems | List accounts with search and pagination |
accountItem | Get a single account by ID |
Mutations (Write)
| Operation | Description |
|---|
addFeedbackItem | Create new feedback |
removeFeedbackItem | Delete feedback by ID |
POST requests with a JSON body containing:
{
"query": "your GraphQL query or mutation",
"variables": { } // optional
}
{
"data": {
// your requested data
},
"errors": [
// any errors that occurred
]
}
Rate Limits
| Tier | Requests per minute |
|---|
| Free | 60 |
| Pro | 300 |
| Enterprise | Unlimited |
Rate limits are applied per API key. Contact support if you need higher limits.
Error Handling
The API returns standard GraphQL errors:
{
"errors": [
{
"message": "Invalid API key",
"extensions": {
"code": "UNAUTHENTICATED"
}
}
]
}
| Code | Description |
|---|
UNAUTHENTICATED | Invalid or missing API key |
FORBIDDEN | Valid key but no access to resource |
NOT_FOUND | Resource does not exist |
BAD_REQUEST | Invalid query or parameters |
