Hey, human!
HTTP/2 200 OK content-type: text/markdown; charset=utf-8 vary: accept, user-agent x-agent: [ai_agent]
Loading the agent response…
Look up a brand from its website address
Searches public sources for a website address (the same step the app runs when you start a brand from a domain) and returns suggestions: brand is a body you can send as it is to createBrand or updateBrand (name, summary, story, industry, size, company_type, year_founded, url, social links, colors, Google fonts), files holds picture addresses to import with the brand file upload (import_url), sources says which provider gave each value and missing lists what was not found. Nothing is saved and no workspace is needed. Check the suggestions before you save them: they come from third parties. The call spends provider credits, so it counts as a search request: 5 units of the daily quota and the plan's search and AI limit a minute per key (keys made before the rollout keep 20 a minute until the grace ends). 404 when nothing is known about the site. Needs brands:read.
What you provide
- Domain: A public website name or address such as acme.com or https://www.acme.com
Do this with AI
I want to look up a brand from its website address. Use the Tarkle API. Read the reference for this operation and follow it exactly: https://project-03b42162.restlessdocs.com/endpoint/lookupbrandfromdomain.md Authenticate with your API key as a Bearer token in the Authorization header. Then make the request for me and tell me what came back.
Paste this into Claude, Cursor, or any AI assistant and it will do it for you.
https://tarkle.com/api/v1/brand-lookupcurl --request POST \
--url https://tarkle.com/api/v1/brand-lookup \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json' \
--data '{"domain":"domain"}'Header parameters
Idempotency-KeystringMakes a write safe to repeat. Send a random value (a UUID is fine) of up to 255 visible characters. A repeat of the same request gets the first answer again, with the header `Idempotent-Replayed: true`, and does nothing twice. The same key for a different request is 422 `idempotency_key_reused`; the same request while the first one is still running is 409 `idempotency_in_progress`. A 5xx or 429 is not remembered, so retrying it runs the request again. Keys last 24 hours and belong to the account that created the token.
Body
application/jsonrequireddomainstringrequiredA public website name or address such as acme.com or https://www.acme.com