Skip to main content

​
Troubleshooting

Common issues and how to resolve them when using the Influship API.

​
Quick Diagnostics

1

Check API Status

Visit status.influship.com to verify service availability.
2

Verify API Key

Test your API key with a simple health check:
curl -H "X-API-Key: YOUR_KEY" https://api.influship.com/health
3

Check Rate Limits

Review response headers for rate limit information:
  • X-RateLimit-Remaining: Requests left in current window
  • X-RateLimit-Reset: When limits reset (Unix timestamp)

​
Authentication Issues

​
401 Unauthorized

Problem: API key is invalid or missing Solutions:
  • Check that your API key is correct
  • Ensure you’re using the X-API-Key header
  • Verify your API key is active in the dashboard

​
403 Forbidden

Problem: API key doesn’t have permission Solutions:
  • Check your account status
  • Verify your subscription is active
  • Contact support if the issue persists

​
Search Issues

​
Empty Search Results

Problem: No creators returned from search Solutions:
  • Try broader search terms (e.g., “fitness” instead of “vegan fitness yoga instructor”)
  • Remove restrictive filters like min_followers or platform
  • Check that your query is in natural language format
  • Verify the search endpoint is working with a simple test query

​
Search Errors

Problem: Search endpoint returns errors Solutions:
  • Verify your request format
  • Check required parameters
  • Ensure your query is properly formatted

​
Rate Limiting

​
429 Too Many Requests

Problem: Exceeded rate limit Solutions:
  • Wait for the rate limit to reset
  • Check X-RateLimit-Reset header
  • Implement exponential backoff
  • Consider upgrading your plan

​
Server Errors

​
500 Internal Server Error

Problem: Server-side issue Solutions:

​
502 Bad Gateway

Problem: Service temporarily unavailable Solutions:
  • Wait a few minutes and retry
  • Check status page for updates
  • Contact support if the issue persists

​
Data Issues

​
Missing Creator Data

Problem: Creator details not available Solutions:
  • Verify the creator ID is a valid UUID format
  • Check if the creator exists by searching for them first
  • Try using mode=detailed for more comprehensive data
  • Ensure you’re using the correct endpoint (/v1/creators for batch requests)

​
Incomplete Profile Information

Problem: Some fields are missing Solutions:
  • Use mode=detailed parameter for extended metrics
  • Add include: ["emails"] for contact information (Pro tier)
  • Use result_scope: "all_platforms" to get data from all known platforms
  • Check if the creator has public profiles on the requested platforms

​
Getting More Help

If you can’t resolve the issue:
  1. Check the FAQ
  2. Review the API Reference
  3. Contact [email protected]