Get Post by URL

​

Overview

​

Authentication

curl -X POST "https://api.trigify.io/v1/post/by-url" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "postUrl": "https://linkedin.com/posts/username_activity-1234567890123456789-abcd"
  }'

​

Response Structure

​

Post Information

• Content: Full text content of the post
• URLs: LinkedIn post URL and any shared links
• Timestamps: Multiple time formats including relative time and exact timestamps
• URN: LinkedIn’s unique identifier for the post

​

Author Details

• Profile Information: Name, headline, LinkedIn profile details
• Professional Data: Current role and company information
• Profile Pictures: Multiple sizes of profile images
• LinkedIn URN: Author’s unique LinkedIn identifier

​

Engagement Metrics

• Like Count: Number of likes on the post
• Comment Count: Number of comments on the post
• Repost Count: Number of times the post has been shared
• Reaction Breakdown: Detailed counts by reaction type (appreciation, praise, etc.)

​

Media Content

• Images: URLs and metadata for any images in the post
• Videos: Video URLs, posters, and duration information
• Documents: Document attachments with download links
• Articles: Shared article links and metadata

​

Company Mentions

• Company Data: Any companies mentioned or tagged in the post
• Logo URLs: Company logos where available

​

Credit Usage

• Successful post retrieval: Uses 1 credit
• Post not found (404): Uses 0 credits
• Invalid URL format (400): Uses 0 credits
• Service error (500): Uses 0 credits

​

Use Cases

• Content Analysis: Analyze the performance and engagement of specific posts
• Competitive Research: Monitor competitor posts and their engagement metrics
• Social Listening: Track specific posts related to your brand or industry
• Lead Generation: Identify high-performing posts to understand what resonates with audiences
• Content Strategy: Research successful content formats and topics
• Influencer Monitoring: Track posts from industry thought leaders and influencers
• Campaign Tracking: Monitor the performance of your own content

​

URL Formats

​

Standard Post URLs

• "https://linkedin.com/posts/username_activity-1234567890123456789-abcd"
• "https://www.linkedin.com/posts/username_activity-1234567890123456789-abcd"

​

Feed Update URLs

• "https://linkedin.com/feed/update/urn:li:activity:1234567890123456789/"
• "https://www.linkedin.com/feed/update/urn:li:activity:1234567890123456789/"

​

Company Post URLs

• "https://linkedin.com/posts/company_activity-1234567890123456789-abcd"

​

Error Handling

​

Common Error Cases

• Invalid URL Format: Returns 400 if the URL is not a valid LinkedIn post URL
• Post Not Found: Returns 404 if the post doesn’t exist or is not accessible
• Permission Denied: Returns 403 if you don’t have the required permissions
• Rate Limited: Returns 429 if you’ve exceeded API rate limits

​

Integration Examples

​

Webhook Integration

// Process webhook with post URL
app.post('/webhook', async (req, res) => {
  const { postUrl } = req.body;
  
  // Enrich the post data
  const enrichedPost = await fetch('/v1/post/by-url', {
    method: 'POST',
    headers: { 
      'Content-Type': 'application/json',
      'x-api-key': API_KEY 
    },
    body: JSON.stringify({ postUrl })
  }).then(r => r.json());
  
  // Process the enriched data
  await processPostData(enrichedPost.data);
});

​

Batch Processing

async def enrich_posts(post_urls):
    enriched_posts = []
    for url in post_urls:
        response = requests.get(
            f"{API_BASE}/post/by-url",
            headers={"x-api-key": API_KEY},
            params={"url": url},
            timeout=30,
        )
        if response.ok:
            body = response.json()
            if body.get("success"):
                enriched_posts.append(body["data"])
    return enriched_posts
        )
        
        if response.json()["success"]:
            enriched_posts.append(response.json()["data"])
            
    return enriched_posts