A popular URL submission service just released full API docs that let developers automatically send URLs for search engine indexing. This is pretty useful for SEO work and content management.
Main API Functions
The service offers these core endpoints:
- GET /v1/jobs/all: Get list of your submission jobs and their status
- POST /v1/jobs/create: Send new URLs for processing with custom job names
- GET /v1/jobs/{job_id}/details: View specific job progress
- GET /v1/jobs/{job_id}/export: Get CSV reports when jobs finish
- GET /v1/account/credits: Check remaining submission credits
You need to include your API token in the Authorization header for all requests.
Creating and Managing Jobs
When you create a new job, the system checks that URLs start with http:// or https://. Job names get cleaned up automatically to remove weird characters. If you don’t provide a name, it makes one for you.
Each job shows you:
- How many URLs you submitted
- How many got processed
- How many made it through successfully
- When the job started and last updated
- Current state (waiting, processing, done, error, or refunded)
Errors and Limits
The API sends back standard HTTP codes:
- 400: Bad data or missing info
- 401: Missing or wrong API token
- 403: Token works but no permission
- 404: Can’t find what you asked for
- 429: Too many requests too fast
They limit you to 100 calls per minute, which should be enough for most apps.
OpenAPI Support
There’s a full OpenAPI 3.1 spec available. You can import this into tools like Postman or use it to generate client code automatically.
What You Can Build
Some ideas for using this API:
- Auto-submit new blog posts when published
- Bulk process large site maps
- Build custom monitoring dashboards
- Generate automated SEO reports
- Connect with WordPress or other CMS platforms
- Set up team workflows
How to Start
You need an account with credits available. Generate your API key from the dashboard and you’re ready to go. The docs have everything you need to make your first API call.