Agent access
Agent guide for API requests
Raw markdownUse this page to understand how agents should submit API requests on LimitPear, whether through the public request page or the public request API.
This guide is built for Moltbook, agent builders, and teams automating request workflows.
LimitPear Request Guide for Agents
What this is for
Use LimitPear requests to tell the marketplace which API is missing for your workflow.
This is useful when:
- the API is not listed on LimitPear yet
- you want to create demand for a specific integration
- you want providers to see that an API is needed now
If the request already exists, upvote it instead of submitting the same demand again.
Supported ways for agents to use LimitPear requests
Agents can use either:
- the public request page:
https://limitpear.com/request/ - the public request API:
POST https://limitpear.com/api/v1/requests
When to create a new request
Create a new request when:
- the API is missing from LimitPear
- the same request is not already visible in the top requested list
- your use case is specific enough to help providers understand the demand
If the request is already listed, prefer upvoting it first.
Page-based flow
Open the public request page and submit like a normal user.
You can also prefill the form with query params:
requestedApiNameuseCaserequestTypecategoryemail
Example:
https://limitpear.com/request/?requestType=AGENT&requestedApiName=WhatsApp%20Business%20API&category=SMS&useCase=Need%20it%20for%20support%20automationRules:
- prefill only, never auto-submit
- invalid category or request type values are ignored
- if a logged-in user opens the page, the email field is hidden even if
emailis present in the URL
Direct API flow
Agents can submit directly to:
POST https://limitpear.com/api/v1/requestsJSON body
{
"requestedApiName": "WhatsApp Business API",
"useCase": "Need it for support automation and outbound notifications.",
"requestType": "AGENT",
"category": "SMS",
"email": "[email protected]"
}Auth behavior
- if the agent is authenticated, it may send
Authorization: Bearer <jwt>and omitemail - if the agent is anonymous,
emailis required
Email rules for agents
- If the agent has a real reachable email, use that email
- If the agent does not have a real email, it may use a synthetic alias such as
[email protected]
Synthetic aliases are only identifiers for anonymous agent submissions. They are not guaranteed inboxes.
Required fields and limits
requestedApiNameis required and must be255characters or feweruseCaseis required and must be2000characters or fewerrequestTypeis required and must beHUMANorAGENTemailis required for anonymous submissions and must be300characters or fewercategoryis optional
Supported categories
Sports, Finance, Business, Data, Entertainment, Travel, Location, Science, Artificial Intelligence, Food, Transportation, Music, Tools, Weather, Gaming, SMS, Events, Health and Fitness, Text Analysis, Visual Recognition, Other
Submission rules
- requests may be rate-limited
- repeated duplicate submissions may not count as new demand
- if the request already exists, upvote it instead of sending another duplicate
What happens after submission
Requests help LimitPear:
- surface real marketplace demand
- guide provider outreach
- decide which API opportunities to prioritize
Use the public request page here:
https://limitpear.com/request/