Documentation
Learn how to submit URLs, check processing status, and manage credits and billing for Google fast indexing and instant indexing workflows.
Welcome to the Shoulu documentation. Create an account, purchase credits, and submit a small batch of URLs from the dashboard. Shoulu checks the URLs and pages before sending submission requests to the provider.
Track submissions
The task page shows three statuses. Filter by status or search by URL or domain:
- Processing: The task is undergoing preflight checks, queued, or awaiting a submission result.
- Success: The provider has accepted the submission request. This does not confirm search engine indexing.
- Failed: Processing could not be completed. Open the task details for available preflight information or contact support.
The current provider's submission API returns acceptance information and a batch number. It does not offer a final indexing-result lookup for individual URLs. The dashboard shows submission processing status; batch acceptance is not proof of search engine indexing, and no next indexing-check time is shown.
Open a task to see its ID, submission time, last update, and available preflight information. Credit changes, payments, and actual refunds remain in Billing.
API statuses
POST /api/v1/urls returns the tasks accepted by the platform. GET /api/v1/tasks/{id} returns a task's current status. Both endpoints use the same status values:
| Value | Display label | Meaning |
|---|---|---|
pending | Processing | The task is being processed |
submitted | Success | The provider has accepted the submission request |
failed | Failed | Processing could not be completed |
The submission response's accepted count means the platform has accepted tasks. It does not mean the provider has accepted them or that search engines have indexed them. Use the task lookup endpoint to check submission processing status.
Read next
- Overview: your first steps with Shoulu.
- API keys: create a key and pick scopes.
- Submit URLs: the
POST /api/v1/urlsreference. - Get a task: the
GET /api/v1/tasks/{id}reference. - Errors and limits: status codes, rejection reasons, and rate limits.