A ranked LinkedIn content API for known topics.
Choose categories or nested topic paths and receive one normalized dataset item per unique public post.
Requests above 10 follow related public topic pages, while topic_rank always preserves the original source-page position.
Know which topic, rank, post, and author fields are returned.
Every result identifies the exact topic page and rank it came from. Optional public values remain null or empty rather than being inferred.
| Fields | Purpose | Availability |
|---|---|---|
topic_title, topic_path, topic_url, topic_category | Source topic identity | Successful results |
topic_rank, sort_position, sort_by | Native rank and returned order | Successful results |
post_id, post_url, text, published_at | Public post identity and content | When public |
author | Name, profile URL, headline, followers, avatar, and badges | When public |
content_type, media, article | Attached content and linked article metadata | When attached |
hashtags, mentions, external_urls | Structured entities and links | When present |
reaction_count, comment_count, repost_count | Public engagement counters | When exposed |
scraped_at, source | Collection time and provenance | Successful results |
Plan the integration with a complete ranked-post record.
This representative response keeps both the LinkedIn source rank and the returned sort position alongside the full post record.
[
{
"topic_title": "Marketing",
"topic_path": "marketing",
"topic_url": "https://www.linkedin.com/top-content/marketing/",
"topic_category": "marketing",
"topic_rank": 1,
"sort_position": 1,
"sort_by": "most_engagement",
"post_id": "7432410076788781057",
"post_url": "https://www.linkedin.com/posts/example_marketing-activity-7432410076788781057-abcd",
"author": {
"name": "Example Author",
"url": "https://www.linkedin.com/in/example",
"headline": "Founder at Example",
"follower_count": 12345,
"avatar_url": "https://media.licdn.com/example-avatar.jpg",
"badges": ["Influencer"]
},
"text": "An example public post about a marketing lesson.",
"published_at": "2026-02-25T13:04:09.808Z",
"relative_time": "5mo",
"content_type": "image",
"is_repost": false,
"media": [{"type":"image","url":"https://media.licdn.com/example-post.jpg","thumbnail_url":null,"title":null,"alt_text":"Example chart"}],
"article": null,
"hashtags": ["Marketing"],
"mentions": [],
"external_urls": [],
"reaction_count": 703,
"comment_count": 98,
"repost_count": null,
"scraped_at": "2026-07-29T12:00:00.000Z",
"source": "linkedin_top_content"
}
]Top Content API versus free research and publishing APIs.
Curly collects ranked public posts from selected topic pages. It does not publish content, and it is deliberately separate from the one-topic free browser experience.
| Option | Starting input | Access | Best for |
|---|---|---|---|
| Official LinkedIn Content APIs | Authorized publishing payload | Restricted LinkedIn access | Creating or managing content |
| Curly free Post Examples Finder | One selected topic | Free browser tool | Exploring up to 10 examples |
| Curly Top Content API | Up to 100 topics or advanced paths | Apify API token | Ranked datasets, sorting, schedules, and webhooks |
| Curly Post Scraper API | Exact /posts/ URLs | Separate Curly endpoint | Known post detail and public comments |
Scale topic research beyond a single browser query.
Use topic paths and post IDs as source keys, then schedule collections, receive webhooks, or export datasets through Apify.
- Review the Top Content Actor on Apify
Create a token, choose multiple topics, set sorting, and connect the dataset.
- Explore one topic in the free browser tool
Preview a small result set before building a larger API workflow.