Piloterr

Patreon Search

GET
/v2/patreon/search

Search Patreon creators by keyword and retrieve campaign cards with patron counts, post counts, and profile URLs.

Credit cost: 1 credit per call

Autorização

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Parâmetros de consulta

query*string

Search keyword to find Patreon creators.

Example:

creator

Notes:

  • Returns matching creator pages with patron counts, post counts, and profile URLs.
  • Use pagination.next or increment the page parameter to fetch additional results.
fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Corpo da resposta

Successful response

application/json
  1. response
query?string
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/patreon/search?query=string'
Example Response
{  "query": "creator",  "results": [    {      "id": "6730893",      "url": "https://www.patreon.com/mrtini23",      "name": "MrTini23",      "thumb": "https://c10.patreonusercontent.com/4/patreon-media/p/campaign/6730893/45f72094d4704e4ebc38656dc63a91e3/eyJ3IjoyNDB9/3.jpg?token-time=2145916800&token-hash=NjIGYFK6C8zd6-nfelA2hysljSu-2dnpLQWzvOz1TRw%3D",      "avatar": "https://c10.patreonusercontent.com/4/patreon-media/p/campaign/6730893/45f72094d4704e4ebc38656dc63a91e3/eyJ3IjoyNDB9/3.jpg?token-time=2145916800&token-hash=NjIGYFK6C8zd6-nfelA2hysljSu-2dnpLQWzvOz1TRw%3D",      "is_nsfw": false,      "summary": null,      "post_count": 14,      "creator_name": "MrTini23",      "patron_count": null,      "creation_name": "Retro Football Manager Content Creator",      "primary_theme_color": "35236"    },    {      "id": "3634516",      "url": "https://www.patreon.com/cfemen",      "name": "cfemen",      "thumb": "https://c10.patreonusercontent.com/4/patreon-media/p/campaign/3634516/d98be5b6694e45c58ba758d186b5a0b1/eyJ3IjoyNDB9/1.jpg?token-time=2145916800&token-hash=Ohlsjl91t-EeaBRJyM0CbV3Z81ried7BEwlqQ5xYgOw%3D",      "avatar": "https://c10.patreonusercontent.com/4/patreon-media/p/campaign/3634516/d98be5b6694e45c58ba758d186b5a0b1/eyJ3IjoyNDB9/1.jpg?token-time=2145916800&token-hash=Ohlsjl91t-EeaBRJyM0CbV3Z81ried7BEwlqQ5xYgOw%3D",      "is_nsfw": false,      "summary": null,      "post_count": 1,      "creator_name": "cfemen",      "patron_count": 10465,      "creation_name": "Game Content Creator",      "primary_theme_color": "36491"    },    {      "id": "10175206",      "url": "https://www.patreon.com/JoshDaly",      "name": "JoshDaly",      "thumb": "https://c10.patreonusercontent.com/4/patreon-media/p/campaign/10175206/e0ce470692e845af8cf5671d2612cb6a/eyJ3IjoyNDB9/3.jpg?token-time=2145916800&token-hash=sMkJSJgskUydmu0ZZ73OrpoOHo2PYwfEPQvjU9ClJ54%3D",      "avatar": "https://c10.patreonusercontent.com/4/patreon-media/p/campaign/10175206/e0ce470692e845af8cf5671d2612cb6a/eyJ3IjoyNDB9/3.jpg?token-time=2145916800&token-hash=sMkJSJgskUydmu0ZZ73OrpoOHo2PYwfEPQvjU9ClJ54%3D",      "is_nsfw": false,      "summary": null,      "post_count": 1379,      "creator_name": "JoshDaly",      "patron_count": 9052,      "creation_name": "Youtube Content Creator ",      "primary_theme_color": "419450"    }  ],  "pagination": {    "next": "https://www.patreon.com/api/search?query=creator&page%5Bnumber%5D=3",    "page": 2,    "prev": "https://www.patreon.com/api/search?query=creator&page%5Bnumber%5D=1",    "hits_total": 66,    "pages_total": 4,    "has_next_page": true,    "has_prev_page": true  }}