Retrieve paid creator results with x402.
CreatorFinder publishes OpenAPI, llms.txt, and runtime x402 metadata so agents can discover the API, create creator searches, inspect price, pay, and handle accepted or empty results.
Paid resource
Resource
GET https://api.creatorfinder.dev/v1/creators/searches/{search_id}/results
Price
USD 0.010000 per accepted creator
Network
eip155:8453
Metadata
/.well-known/x402
Discovery checks
npx -y agentcash@latest discover api.creatorfinder.dev
curl -X POST https://api.creatorfinder.dev/v1/creators/searches/quote \
-H "content-type: application/json" \
-d '{"segment":"fashion creators","max_results":25}'
Agent prompt
Use x402 to call CreatorFinder:
1. Create a creator search:
POST https://api.creatorfinder.dev/v1/creators/searches
Input:
{
"segment": "fashion creators",
"platforms": ["tiktok", "instagram"],
"max_results": 25,
"budget_cap_usd": 0.25
}
2. Poll search status until complete.
3. Use an x402-capable client on:
GET https://api.creatorfinder.dev/v1/creators/searches/{search_id}/results
Pay only if the runtime x402 challenge matches the published price,
network, resource URL, and receiver metadata.
Expected results
The paid results call returns accepted creator records plus rejection metadata. Searches with no accepted creators are not billable. Runtime x402 challenges and settlement responses are authoritative.