canonical: https://jentic.com/apis/scoop.it/scoop-it

# Scoop.it API

Scoop.it is a content curation platform. The API provides programmatic access to user profiles, curated topics, posts, notifications, search, suggestion engines, and recipient lists. Supports both anonymous access (read-only with consumer token) and authenticated access (full read/write with OAuth 2.0). The API exposes 24 endpoints secured with oauth2 authentication.

## For AI agents

Programmatically get user profile, perform topic action. Covers 24 operations with oauth2 authentication.

## Scope

Does not handle payments, communications, or crm - use for social media only.

## Capabilities

- Get user profile
- Perform topic action
- Test authentication
- Query and filter Scoop.it API records by parameters
- Monitor Scoop.it API operational status and events

## Use cases

### Social Media Operations

Use the Scoop.it API to perform social media operations programmatically. The API provides 24 endpoints covering core functionality including get user profile, perform topic action, get topic.

Example prompt: Call GET /profile to get user profile

### Automated Profile Management

Automate profile operations by combining multiple Scoop.it API endpoints. Agents can perform topic action and then get topic in a single workflow.

Example prompt: Call POST /topic to perform topic action, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call Scoop.it API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle oauth2 tokens manually.

Example prompt: Search Jentic for 'get user profile', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/profile` | Get user profile |
| POST | `/topic` | Perform topic action |
| GET | `/topic` | Get topic |
| POST | `/post` | Perform post action |
| GET | `/post` | Get post |
| GET | `/test` | Test authentication |
| GET | `/notifications` | Get notifications |
| GET | `/compilation` | Get post compilation |

## Key resources

- **Profile** — User profile operations
- **Topics** — Topic management and retrieval
- **Posts** — Post creation, curation, and management
- **Notifications** — User notification retrieval
- **Search** — Search for users, topics, and posts

## Why Jentic

- **Setup:** Wiring the Scoop.it API by hand means implementing its OAuth 2.0 flow, managing tokens against www.scoop.it, and building retries yourself. Through Jentic you install once, import Scoop.it from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** Scoop.it identifies topics and posts in the request body rather than the URL path, so you limit the agent to the operations it needs, such as reading a profile or listing posts. You choose the operations it may call, so creating a topic or publishing a post is not included unless you add it.
- **Credential handling:** Your Scoop.it OAuth token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'get the user profile' or 'list posts on a topic', and Jentic returns the matching Scoop.it operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Facebook** — Alternative social media API
- **Twitter** — Alternative social media API
- **Linkedin** — Complementary social media API

## FAQ

### What authentication does the Scoop.it API use?

The Scoop.it API uses OAuth 2.0 for authorization. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I get user profile with the Scoop.it API?

Yes. Use the GET /profile endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the Scoop.it API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I get user profile through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'get user profile'. Jentic returns the matching Scoop.it API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Scoop.it API have?

The Scoop.it API exposes 24 endpoints covering profile, topics, posts operations.

### Can I limit what my agent is allowed to do with the Scoop.it API?

Yes. Because you self-host Jentic One, your own rules decide which Scoop.it operations the agent may call, so you can grant read-only access such as GET /profile to fetch a user profile or GET /post to list posts on a topic. Scoop.it identifies topics and posts in the request body rather than the URL path, so you scope by choosing whole operations: write actions like POST /topic to create a topic or POST /post to publish are excluded unless you explicitly add them. The OAuth token stays encrypted in your own instance and is injected only for the operations you allow.