GET /content/:id

The GET /content/:id endpoint allows you to check the status of a previously submitted content request and retrieve the results when processing is complete. This endpoint is used for polling the status of your request until it's ready.

Endpoint

Path Parameters

Headers

Response

The response from the GET /content/:id endpoint will vary depending on the current status of the content request. There are three possible status values: "processing", "completed", and "failed".

Processing Status Response

When the content is still being processed, the response will include the status:

{
  "id": "ins_01H9XK7ABCDEFGHIJKLMNOPQRS",
  "status": "processing",
  "created_at": "2023-09-15T14:23:45Z"
}

Completed Status Response

When the content processing is complete, the response will include the full content data:

{
  "id": "ins_01H9XK7ABCDEFGHIJKLMNOPQRS",
  "status": "completed",
  "created_at": "2023-09-15T14:23:45Z",
  "completed_at": "2023-09-15T14:24:15Z",
  "result": {
    "topic": "AI trends in healthcare",
    "insight": "AI is transforming healthcare through several key trends...

... (450 words, truncated)"
  }
}

Polling Best Practices

When polling for the status of a content request, follow these best practices to ensure efficient usage of the API:

1. Implement exponential backoff - Start with a short interval between requests (e.g., 3 second) and gradually increase it to avoid overwhelming the API.
2. Set a maximum polling interval - Cap the interval at a reasonable maximum (e.g., 10 seconds) to ensure timely updates.

Example Polling Implementation

Here are examples of how to implement polling with exponential backoff in different programming languages:

// Node.js polling example
async function pollContent(contentId) {
  const apiKey = 'YOUR_API_KEY';
  const apiUrl = 'https://trendifi.app/api/v1';
  let delay = 3000; // Start with 3 second delay to avoid rate limiting
  
  while (true) {
    try {
      const response = await fetch(apiUrl + '/content/' + contentId, {
        headers: {
          'Authorization': 'Bearer ' + apiKey
        }
      });
      
      if (!response.ok) {
        throw new Error('HTTP error! status: ' + response.status);
      }
      
      const data = await response.json();
      
      if (data.status === 'completed') {
        console.log('Content is ready!');
        return data.result;
      } else if (data.status === 'failed') {
        throw new Error('Content processing failed: ' + data.error.message);
      }
      
      // Still processing, wait and try again
      console.log('Content still processing...');
      delay = Math.min(delay * 1.5, 30000); // Max delay of 30 seconds
      await new Promise(resolve => setTimeout(resolve, delay));
    } catch (error) {
      console.error('Error polling content:', error);
      throw error;
    }
  }
}