API Reference - Creator Scraper API

Base URL

https://api.scraper.creatorlookup.com

All /v1/* endpoints require an API key in the x-api-key header:

curl -H "x-api-key: sk-your-api-key" \
  https://api.scraper.creatorlookup.com/v1/credit-balance

All successful scrape responses follow the same envelope:

{
  "data": { ... },
  "credits_used": 1,
  "credits_remaining": 9999
}

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description"
  }
}

See Errors for the full list of error codes.

Method	Path	Auth	Description
GET	`/health`	No	Health check

Method	Path	Credits	Description
GET	`/v1/credit-balance`	0	Check remaining credits

Method	Path	Credits	Description
GET	`/v1/instagram/profile`	1	Get user profile
GET	`/v1/instagram/user/posts`	2	Get user’s recent posts
GET	`/v1/instagram/post`	1	Get single post by shortcode
GET	`/v1/instagram/post/comments`	2	Get comments on a post
GET	`/v1/instagram/hashtag/posts`	1	Search posts by hashtag

Responses are cached server-side to improve performance:

Cached responses still cost credits. The X-Request-ID header is included on every response for debugging.

The full OpenAPI 3.1 spec is available at: